Revision: 1170
Author:
J.S.P...@gmail.com
Date: Mon Aug 19 17:06:11 2013 UTC
Log: Release 18
http://code.google.com/p/roster-dns-management/source/detail?r=1170
Added:
/tags/release-0.18
/tags/release-0.18/roster-config-manager/docs
/tags/release-0.18/roster-config-manager/docs/html
/tags/release-0.18/roster-config-manager/docs/html/.buildinfo
/tags/release-0.18/roster-config-manager/docs/html/_modules
/tags/release-0.18/roster-config-manager/docs/html/_modules/index.html
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager/__init__.html
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager/config_lib.html
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager/db_recovery.html
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager/dns_query_lib.html
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager/tree_exporter.html
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager/zone_exporter_lib.html
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager/zone_importer_lib.html
/tags/release-0.18/roster-config-manager/docs/html/_sources
/tags/release-0.18/roster-config-manager/docs/html/_sources/index.txt
/tags/release-0.18/roster-config-manager/docs/html/_sources/roster_config_manager.txt
/tags/release-0.18/roster-config-manager/docs/html/_static
/tags/release-0.18/roster-config-manager/docs/html/_static/ajax-loader.gif
/tags/release-0.18/roster-config-manager/docs/html/_static/basic.css
/tags/release-0.18/roster-config-manager/docs/html/_static/comment-bright.png
/tags/release-0.18/roster-config-manager/docs/html/_static/comment-close.png
/tags/release-0.18/roster-config-manager/docs/html/_static/comment.png
/tags/release-0.18/roster-config-manager/docs/html/_static/default.css
/tags/release-0.18/roster-config-manager/docs/html/_static/doctools.js
/tags/release-0.18/roster-config-manager/docs/html/_static/down-pressed.png
/tags/release-0.18/roster-config-manager/docs/html/_static/down.png
/tags/release-0.18/roster-config-manager/docs/html/_static/file.png
/tags/release-0.18/roster-config-manager/docs/html/_static/jquery.js
/tags/release-0.18/roster-config-manager/docs/html/_static/minus.png
/tags/release-0.18/roster-config-manager/docs/html/_static/plus.png
/tags/release-0.18/roster-config-manager/docs/html/_static/pygments.css
/tags/release-0.18/roster-config-manager/docs/html/_static/searchtools.js
/tags/release-0.18/roster-config-manager/docs/html/_static/sidebar.js
/tags/release-0.18/roster-config-manager/docs/html/_static/underscore.js
/tags/release-0.18/roster-config-manager/docs/html/_static/up-pressed.png
/tags/release-0.18/roster-config-manager/docs/html/_static/up.png
/tags/release-0.18/roster-config-manager/docs/html/_static/websupport.js
/tags/release-0.18/roster-config-manager/docs/html/genindex.html
/tags/release-0.18/roster-config-manager/docs/html/index.html
/tags/release-0.18/roster-config-manager/docs/html/objects.inv
/tags/release-0.18/roster-config-manager/docs/html/py-modindex.html
/tags/release-0.18/roster-config-manager/docs/html/roster_config_manager.html
/tags/release-0.18/roster-config-manager/docs/html/search.html
/tags/release-0.18/roster-config-manager/docs/html/searchindex.js
/tags/release-0.18/roster-core/docs
/tags/release-0.18/roster-core/docs/html
/tags/release-0.18/roster-core/docs/html/.buildinfo
/tags/release-0.18/roster-core/docs/html/_modules
/tags/release-0.18/roster-core/docs/html/_modules/index.html
/tags/release-0.18/roster-core/docs/html/_modules/roster_core
/tags/release-0.18/roster-core/docs/html/_modules/roster_core/__init__.html
/tags/release-0.18/roster-core/docs/html/_modules/roster_core/audit_log.html
/tags/release-0.18/roster-core/docs/html/_modules/roster_core/config.html
/tags/release-0.18/roster-core/docs/html/_modules/roster_core/core.html
/tags/release-0.18/roster-core/docs/html/_modules/roster_core/core_helpers.html
/tags/release-0.18/roster-core/docs/html/_modules/roster_core/data_validation.html
/tags/release-0.18/roster-core/docs/html/_modules/roster_core/db_access.html
/tags/release-0.18/roster-core/docs/html/_modules/roster_core/errors.html
/tags/release-0.18/roster-core/docs/html/_modules/roster_core/helpers_lib.html
/tags/release-0.18/roster-core/docs/html/_modules/roster_core/punycode_lib.html
/tags/release-0.18/roster-core/docs/html/_modules/roster_core/user.html
/tags/release-0.18/roster-core/docs/html/_sources
/tags/release-0.18/roster-core/docs/html/_sources/index.txt
/tags/release-0.18/roster-core/docs/html/_sources/roster_core.txt
/tags/release-0.18/roster-core/docs/html/_static
/tags/release-0.18/roster-core/docs/html/_static/ajax-loader.gif
/tags/release-0.18/roster-core/docs/html/_static/basic.css
/tags/release-0.18/roster-core/docs/html/_static/comment-bright.png
/tags/release-0.18/roster-core/docs/html/_static/comment-close.png
/tags/release-0.18/roster-core/docs/html/_static/comment.png
/tags/release-0.18/roster-core/docs/html/_static/default.css
/tags/release-0.18/roster-core/docs/html/_static/doctools.js
/tags/release-0.18/roster-core/docs/html/_static/down-pressed.png
/tags/release-0.18/roster-core/docs/html/_static/down.png
/tags/release-0.18/roster-core/docs/html/_static/file.png
/tags/release-0.18/roster-core/docs/html/_static/jquery.js
/tags/release-0.18/roster-core/docs/html/_static/minus.png
/tags/release-0.18/roster-core/docs/html/_static/plus.png
/tags/release-0.18/roster-core/docs/html/_static/pygments.css
/tags/release-0.18/roster-core/docs/html/_static/searchtools.js
/tags/release-0.18/roster-core/docs/html/_static/sidebar.js
/tags/release-0.18/roster-core/docs/html/_static/underscore.js
/tags/release-0.18/roster-core/docs/html/_static/up-pressed.png
/tags/release-0.18/roster-core/docs/html/_static/up.png
/tags/release-0.18/roster-core/docs/html/_static/websupport.js
/tags/release-0.18/roster-core/docs/html/genindex.html
/tags/release-0.18/roster-core/docs/html/index.html
/tags/release-0.18/roster-core/docs/html/objects.inv
/tags/release-0.18/roster-core/docs/html/py-modindex.html
/tags/release-0.18/roster-core/docs/html/roster_core.html
/tags/release-0.18/roster-core/docs/html/search.html
/tags/release-0.18/roster-core/docs/html/searchindex.js
/tags/release-0.18/roster-server/docs
/tags/release-0.18/roster-server/docs/html
/tags/release-0.18/roster-server/docs/html/.buildinfo
/tags/release-0.18/roster-server/docs/html/_modules
/tags/release-0.18/roster-server/docs/html/_modules/index.html
/tags/release-0.18/roster-server/docs/html/_modules/roster_server
/tags/release-0.18/roster-server/docs/html/_modules/roster_server/__init__.html
/tags/release-0.18/roster-server/docs/html/_modules/roster_server/auth_developer.html
/tags/release-0.18/roster-server/docs/html/_modules/roster_server/auth_pam.html
/tags/release-0.18/roster-server/docs/html/_modules/roster_server/credentials.html
/tags/release-0.18/roster-server/docs/html/_modules/roster_server/general_ldap.html
/tags/release-0.18/roster-server/docs/html/_modules/roster_server/server.html
/tags/release-0.18/roster-server/docs/html/_modules/roster_server/ssl_xml_rpc_lib.html
/tags/release-0.18/roster-server/docs/html/_sources
/tags/release-0.18/roster-server/docs/html/_sources/index.txt
/tags/release-0.18/roster-server/docs/html/_sources/roster_server.txt
/tags/release-0.18/roster-server/docs/html/_static
/tags/release-0.18/roster-server/docs/html/_static/ajax-loader.gif
/tags/release-0.18/roster-server/docs/html/_static/basic.css
/tags/release-0.18/roster-server/docs/html/_static/comment-bright.png
/tags/release-0.18/roster-server/docs/html/_static/comment-close.png
/tags/release-0.18/roster-server/docs/html/_static/comment.png
/tags/release-0.18/roster-server/docs/html/_static/default.css
/tags/release-0.18/roster-server/docs/html/_static/doctools.js
/tags/release-0.18/roster-server/docs/html/_static/down-pressed.png
/tags/release-0.18/roster-server/docs/html/_static/down.png
/tags/release-0.18/roster-server/docs/html/_static/file.png
/tags/release-0.18/roster-server/docs/html/_static/jquery.js
/tags/release-0.18/roster-server/docs/html/_static/minus.png
/tags/release-0.18/roster-server/docs/html/_static/plus.png
/tags/release-0.18/roster-server/docs/html/_static/pygments.css
/tags/release-0.18/roster-server/docs/html/_static/searchtools.js
/tags/release-0.18/roster-server/docs/html/_static/sidebar.js
/tags/release-0.18/roster-server/docs/html/_static/underscore.js
/tags/release-0.18/roster-server/docs/html/_static/up-pressed.png
/tags/release-0.18/roster-server/docs/html/_static/up.png
/tags/release-0.18/roster-server/docs/html/_static/websupport.js
/tags/release-0.18/roster-server/docs/html/genindex.html
/tags/release-0.18/roster-server/docs/html/index.html
/tags/release-0.18/roster-server/docs/html/objects.inv
/tags/release-0.18/roster-server/docs/html/py-modindex.html
/tags/release-0.18/roster-server/docs/html/roster_server.html
/tags/release-0.18/roster-server/docs/html/search.html
/tags/release-0.18/roster-server/docs/html/searchindex.js
/tags/release-0.18/roster-user-tools/docs
/tags/release-0.18/roster-user-tools/docs/html
/tags/release-0.18/roster-user-tools/docs/html/.buildinfo
/tags/release-0.18/roster-user-tools/docs/html/_modules
/tags/release-0.18/roster-user-tools/docs/html/_modules/index.html
/tags/release-0.18/roster-user-tools/docs/html/_modules/roster_user_tools
/tags/release-0.18/roster-user-tools/docs/html/_modules/roster_user_tools/action_flags.html
/tags/release-0.18/roster-user-tools/docs/html/_modules/roster_user_tools/cli_common_lib.html
/tags/release-0.18/roster-user-tools/docs/html/_modules/roster_user_tools/cli_record_lib.html
/tags/release-0.18/roster-user-tools/docs/html/_modules/roster_user_tools/core_flags.html
/tags/release-0.18/roster-user-tools/docs/html/_modules/roster_user_tools/data_flags.html
/tags/release-0.18/roster-user-tools/docs/html/_modules/roster_user_tools/roster_client_lib.html
/tags/release-0.18/roster-user-tools/docs/html/_sources
/tags/release-0.18/roster-user-tools/docs/html/_sources/index.txt
/tags/release-0.18/roster-user-tools/docs/html/_sources/roster_user_tools.txt
/tags/release-0.18/roster-user-tools/docs/html/_static
/tags/release-0.18/roster-user-tools/docs/html/_static/ajax-loader.gif
/tags/release-0.18/roster-user-tools/docs/html/_static/basic.css
/tags/release-0.18/roster-user-tools/docs/html/_static/comment-bright.png
/tags/release-0.18/roster-user-tools/docs/html/_static/comment-close.png
/tags/release-0.18/roster-user-tools/docs/html/_static/comment.png
/tags/release-0.18/roster-user-tools/docs/html/_static/default.css
/tags/release-0.18/roster-user-tools/docs/html/_static/doctools.js
/tags/release-0.18/roster-user-tools/docs/html/_static/down-pressed.png
/tags/release-0.18/roster-user-tools/docs/html/_static/down.png
/tags/release-0.18/roster-user-tools/docs/html/_static/file.png
/tags/release-0.18/roster-user-tools/docs/html/_static/jquery.js
/tags/release-0.18/roster-user-tools/docs/html/_static/minus.png
/tags/release-0.18/roster-user-tools/docs/html/_static/plus.png
/tags/release-0.18/roster-user-tools/docs/html/_static/pygments.css
/tags/release-0.18/roster-user-tools/docs/html/_static/searchtools.js
/tags/release-0.18/roster-user-tools/docs/html/_static/sidebar.js
/tags/release-0.18/roster-user-tools/docs/html/_static/underscore.js
/tags/release-0.18/roster-user-tools/docs/html/_static/up-pressed.png
/tags/release-0.18/roster-user-tools/docs/html/_static/up.png
/tags/release-0.18/roster-user-tools/docs/html/_static/websupport.js
/tags/release-0.18/roster-user-tools/docs/html/genindex.html
/tags/release-0.18/roster-user-tools/docs/html/index.html
/tags/release-0.18/roster-user-tools/docs/html/objects.inv
/tags/release-0.18/roster-user-tools/docs/html/py-modindex.html
/tags/release-0.18/roster-user-tools/docs/html/roster_user_tools.html
/tags/release-0.18/roster-user-tools/docs/html/search.html
/tags/release-0.18/roster-user-tools/docs/html/searchindex.js
/wiki/DatabaseSchema/db_schema_0.18.png
/wiki/DatabaseSchema/db_schema_0.18.sql
/wiki/DatabaseSchema/thumbnail_0.18.png
Modified:
/cut_tag.py
/tags/release-0.18/roster-config-manager/Authors
/tags/release-0.18/roster-config-manager/ChangeLog
/tags/release-0.18/roster-config-manager/License
/tags/release-0.18/roster-config-manager/MANIFEST
/tags/release-0.18/roster-config-manager/roster_config_manager/__init__.py
/tags/release-0.18/roster-config-manager/roster_config_manager/config_lib.py
/tags/release-0.18/roster-config-manager/roster_config_manager/db_recovery.py
/tags/release-0.18/roster-config-manager/roster_config_manager/dns_query_lib.py
/tags/release-0.18/roster-config-manager/roster_config_manager/tree_exporter.py
/tags/release-0.18/roster-config-manager/roster_config_manager/zone_exporter_lib.py
/tags/release-0.18/roster-config-manager/roster_config_manager/zone_importer_lib.py
/tags/release-0.18/roster-config-manager/scripts/dnscheckconfig
/tags/release-0.18/roster-config-manager/scripts/dnsconfigsync
/tags/release-0.18/roster-config-manager/scripts/dnsexportconfig
/tags/release-0.18/roster-config-manager/scripts/dnsquerycheck
/tags/release-0.18/roster-config-manager/scripts/dnsrecover
/tags/release-0.18/roster-config-manager/scripts/dnsservercheck
/tags/release-0.18/roster-config-manager/scripts/dnstreeexport
/tags/release-0.18/roster-config-manager/scripts/dnsversioncheck
/tags/release-0.18/roster-config-manager/scripts/dnszonecompare
/tags/release-0.18/roster-config-manager/scripts/dnszoneimporter
/tags/release-0.18/roster-config-manager/setup.py
/tags/release-0.18/roster-core/Authors
/tags/release-0.18/roster-core/ChangeLog
/tags/release-0.18/roster-core/License
/tags/release-0.18/roster-core/MANIFEST
/tags/release-0.18/roster-core/roster_core/__init__.py
/tags/release-0.18/roster-core/roster_core/audit_log.py
/tags/release-0.18/roster-core/roster_core/config.py
/tags/release-0.18/roster-core/roster_core/constants.py
/tags/release-0.18/roster-core/roster_core/core.py
/tags/release-0.18/roster-core/roster_core/core_helpers.py
/tags/release-0.18/roster-core/roster_core/data_validation.py
/tags/release-0.18/roster-core/roster_core/db_access.py
/tags/release-0.18/roster-core/roster_core/embedded_files.py
/tags/release-0.18/roster-core/roster_core/errors.py
/tags/release-0.18/roster-core/roster_core/helpers_lib.py
/tags/release-0.18/roster-core/roster_core/punycode_lib.py
/tags/release-0.18/roster-core/roster_core/user.py
/tags/release-0.18/roster-core/scripts/roster_database_bootstrap
/tags/release-0.18/roster-core/setup.py
/tags/release-0.18/roster-server/Authors
/tags/release-0.18/roster-server/ChangeLog
/tags/release-0.18/roster-server/License
/tags/release-0.18/roster-server/MANIFEST
/tags/release-0.18/roster-server/roster_server/__init__.py
/tags/release-0.18/roster-server/roster_server/auth_developer.py
/tags/release-0.18/roster-server/roster_server/auth_pam.py
/tags/release-0.18/roster-server/roster_server/credentials.py
/tags/release-0.18/roster-server/roster_server/general_ldap.py
/tags/release-0.18/roster-server/roster_server/server.py
/tags/release-0.18/roster-server/roster_server/ssl_xml_rpc_lib.py
/tags/release-0.18/roster-server/scripts/rosterd
/tags/release-0.18/roster-server/setup.py
/tags/release-0.18/roster-user-tools/Authors
/tags/release-0.18/roster-user-tools/ChangeLog
/tags/release-0.18/roster-user-tools/License
/tags/release-0.18/roster-user-tools/MANIFEST
/tags/release-0.18/roster-user-tools/roster_user_tools/__init__.py
/tags/release-0.18/roster-user-tools/roster_user_tools/action_flags.py
/tags/release-0.18/roster-user-tools/roster_user_tools/cli_common_lib.py
/tags/release-0.18/roster-user-tools/roster_user_tools/cli_record_lib.py
/tags/release-0.18/roster-user-tools/roster_user_tools/core_flags.py
/tags/release-0.18/roster-user-tools/roster_user_tools/data_flags.py
/tags/release-0.18/roster-user-tools/roster_user_tools/roster_client_lib.py
/tags/release-0.18/roster-user-tools/scripts/dnsaddformattedrecords
/tags/release-0.18/roster-user-tools/scripts/dnscredential
/tags/release-0.18/roster-user-tools/scripts/dnslsacl
/tags/release-0.18/roster-user-tools/scripts/dnslsauditlog
/tags/release-0.18/roster-user-tools/scripts/dnslscnames
/tags/release-0.18/roster-user-tools/scripts/dnslsdnsserver
/tags/release-0.18/roster-user-tools/scripts/dnslshost
/tags/release-0.18/roster-user-tools/scripts/dnslshostfile
/tags/release-0.18/roster-user-tools/scripts/dnslsrecord
/tags/release-0.18/roster-user-tools/scripts/dnslsreservedword
/tags/release-0.18/roster-user-tools/scripts/dnslsusergroup
/tags/release-0.18/roster-user-tools/scripts/dnslsview
/tags/release-0.18/roster-user-tools/scripts/dnslszone
/tags/release-0.18/roster-user-tools/scripts/dnsmassadd
/tags/release-0.18/roster-user-tools/scripts/dnsmkacl
/tags/release-0.18/roster-user-tools/scripts/dnsmkdnsserver
/tags/release-0.18/roster-user-tools/scripts/dnsmkhost
/tags/release-0.18/roster-user-tools/scripts/dnsmkrecord
/tags/release-0.18/roster-user-tools/scripts/dnsmkreservedword
/tags/release-0.18/roster-user-tools/scripts/dnsmkusergroup
/tags/release-0.18/roster-user-tools/scripts/dnsmkview
/tags/release-0.18/roster-user-tools/scripts/dnsmkzone
/tags/release-0.18/roster-user-tools/scripts/dnsrmacl
/tags/release-0.18/roster-user-tools/scripts/dnsrmdnsserver
/tags/release-0.18/roster-user-tools/scripts/dnsrmhost
/tags/release-0.18/roster-user-tools/scripts/dnsrmrecord
/tags/release-0.18/roster-user-tools/scripts/dnsrmreservedword
/tags/release-0.18/roster-user-tools/scripts/dnsrmusergroup
/tags/release-0.18/roster-user-tools/scripts/dnsrmview
/tags/release-0.18/roster-user-tools/scripts/dnsrmzone
/tags/release-0.18/roster-user-tools/scripts/dnssetmaintenance
/tags/release-0.18/roster-user-tools/scripts/dnsuphosts
/tags/release-0.18/roster-user-tools/scripts/dnsupnamedglobals
/tags/release-0.18/roster-user-tools/scripts/dnsupusergroup
/tags/release-0.18/roster-user-tools/scripts/roster_user_tools_bootstrap
/tags/release-0.18/roster-user-tools/setup.py
/tags/release-0.18/test/audit_log_unittest.py
/tags/release-0.18/test/cli_common_lib_test.py
/tags/release-0.18/test/cli_record_lib_test.py
/tags/release-0.18/test/config_lib_test.py
/tags/release-0.18/test/core_helpers_regtest.py
/tags/release-0.18/test/core_regtest.py
/tags/release-0.18/test/credentials_test.py
/tags/release-0.18/test/data_validation_unittest.py
/tags/release-0.18/test/db_access_unittest.py
/tags/release-0.18/test/db_recovery_unittest.py
/tags/release-0.18/test/dirty_core_test.py
/tags/release-0.18/test/dnsaddformattedrecords_test.py
/tags/release-0.18/test/dnscheckconfig_test.py
/tags/release-0.18/test/dnsconfigsync_test.py
/tags/release-0.18/test/dnscredential_test.py
/tags/release-0.18/test/dnsexportconfig_test.py
/tags/release-0.18/test/dnslsacl_test.py
/tags/release-0.18/test/dnslsauditlog_test.py
/tags/release-0.18/test/dnslscnames_test.py
/tags/release-0.18/test/dnslsdnsserver_test.py
/tags/release-0.18/test/dnslshost_test.py
/tags/release-0.18/test/dnslshostfile_test.py
/tags/release-0.18/test/dnslsrecord_test.py
/tags/release-0.18/test/dnslsreservedword_test.py
/tags/release-0.18/test/dnslsusergroup_test.py
/tags/release-0.18/test/dnslsview_test.py
/tags/release-0.18/test/dnslszone_test.py
/tags/release-0.18/test/dnsmassadd_test.py
/tags/release-0.18/test/dnsmkacl_test.py
/tags/release-0.18/test/dnsmkdnsservers_test.py
/tags/release-0.18/test/dnsmkhost_test.py
/tags/release-0.18/test/dnsmkrecord_test.py
/tags/release-0.18/test/dnsmkreservedword_test.py
/tags/release-0.18/test/dnsmkusergroup_test.py
/tags/release-0.18/test/dnsmkview_test.py
/tags/release-0.18/test/dnsmkzone_test.py
/tags/release-0.18/test/dnsquerycheck_test.py
/tags/release-0.18/test/dnsrecover_test.py
/tags/release-0.18/test/dnsrmacl_test.py
/tags/release-0.18/test/dnsrmdnsserver_test.py
/tags/release-0.18/test/dnsrmhost_test.py
/tags/release-0.18/test/dnsrmrecord_test.py
/tags/release-0.18/test/dnsrmreservedword_test.py
/tags/release-0.18/test/dnsrmusergroup_test.py
/tags/release-0.18/test/dnsrmview_test.py
/tags/release-0.18/test/dnsrmzone_test.py
/tags/release-0.18/test/dnsservercheck_test.py
/tags/release-0.18/test/dnssetmaintenance_test.py
/tags/release-0.18/test/dnstreeexport_test.py
/tags/release-0.18/test/dnsuphosts_test.py
/tags/release-0.18/test/dnsupnamedglobals_test.py
/tags/release-0.18/test/dnsupusergroup_test.py
/tags/release-0.18/test/dnsversioncheck_test.py
/tags/release-0.18/test/dnszoneimporter_test.py
/tags/release-0.18/test/end_to_end_test.py
/tags/release-0.18/test/fake_credentials.py
/tags/release-0.18/test/fake_editor.py
/tags/release-0.18/test/fakeldap.py
/tags/release-0.18/test/fakepam.py
/tags/release-0.18/test/flags_test.py
/tags/release-0.18/test/general_ldap_test.py
/tags/release-0.18/test/helpers_lib_unittest.py
/tags/release-0.18/test/import_and_export_all_university_records.py
/tags/release-0.18/test/pam_test.py
/tags/release-0.18/test/punycode_lib_test.py
/tags/release-0.18/test/pylint_test.py
/tags/release-0.18/test/roster_client_lib_test.py
/tags/release-0.18/test/roster_database_bootstrap_test.py
/tags/release-0.18/test/roster_user_tools_bootstrap_test.py
/tags/release-0.18/test/rosterd_test.py
/tags/release-0.18/test/smtplib.py
/tags/release-0.18/test/tree_exporter_test.py
/tags/release-0.18/test/user_unittest.py
/tags/release-0.18/test/xml_rpc_client_regtest.py
/tags/release-0.18/test/xml_rpc_server_test.py
/tags/release-0.18/test/zone_exporter_lib_regtest.py
/tags/release-0.18/test/zone_importer_lib_regtest.py
/trunk/roster-config-manager/ChangeLog
/trunk/roster-core/ChangeLog
/trunk/roster-server/ChangeLog
/trunk/roster-user-tools/ChangeLog
/wiki/DeveloperDocumentation.wiki
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/.buildinfo Mon Aug
19 17:06:11 2013 UTC
@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When
it is not found, a full rebuild will be done.
+config: 9054c9d19843a3d7639f7b8b787c429b
+tags: a205e9ed8462ae86fdd2f73488852ba9
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/_modules/index.html
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,96 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="
http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Overview: module code — Roster Config Manager v0.18
documentation</title>
+
+ <link rel="stylesheet" href="../_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="../_static/pygments.css" type="text/css"
/>
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: '../',
+ VERSION: 'v0.18',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="../_static/jquery.js"></script>
+ <script type="text/javascript" src="../_static/underscore.js"></script>
+ <script type="text/javascript" src="../_static/doctools.js"></script>
+ <link rel="top" title="Roster Config Manager v0.18 documentation"
href="../index.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <h1>All modules for which code is available</h1>
+<ul><li><a
href="roster_config_manager/__init__.html">roster_config_manager.__init__</a></li>
+<li><a
href="roster_config_manager/config_lib.html">roster_config_manager.config_lib</a></li>
+<li><a
href="roster_config_manager/db_recovery.html">roster_config_manager.db_recovery</a></li>
+<li><a
href="roster_config_manager/dns_query_lib.html">roster_config_manager.dns_query_lib</a></li>
+<li><a
href="roster_config_manager/tree_exporter.html">roster_config_manager.tree_exporter</a></li>
+<li><a
href="roster_config_manager/zone_exporter_lib.html">roster_config_manager.zone_exporter_lib</a></li>
+<li><a
href="roster_config_manager/zone_importer_lib.html">roster_config_manager.zone_importer_lib</a></li>
+</ul>
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="../search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2013, Purdue University.
+ Created using <a href="
http://sphinx-doc.org/">Sphinx</a> 1.2b1.
+ </div>
+ </body>
+</html>
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager/__init__.html
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,138 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="
http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>roster_config_manager.__init__ — Roster Config Manager
v0.18 documentation</title>
+
+ <link rel="stylesheet" href="../../_static/default.css"
type="text/css" />
+ <link rel="stylesheet" href="../../_static/pygments.css"
type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: '../../',
+ VERSION: 'v0.18',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="../../_static/jquery.js"></script>
+ <script type="text/javascript"
src="../../_static/underscore.js"></script>
+ <script type="text/javascript"
src="../../_static/doctools.js"></script>
+ <link rel="top" title="Roster Config Manager v0.18 documentation"
href="../../index.html" />
+ <link rel="up" title="Module code" href="../index.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../../genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ <li><a href="../index.html" accesskey="U">Module code</a>
»</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <h1>Source code for roster_config_manager.__init__</h1><div
class="highlight"><pre>
+<span class="c">#!/usr/bin/python</span>
+
+<span class="c"># Copyright (c) 2009, Purdue University</span>
+<span class="c"># All rights reserved.</span>
+<span class="c"># </span>
+<span class="c"># Redistribution and use in source and binary forms, with
or without</span>
+<span class="c"># modification, are permitted provided that the following
conditions are met:</span>
+<span class="c"># </span>
+<span class="c"># Redistributions of source code must retain the above
copyright notice, this</span>
+<span class="c"># list of conditions and the following disclaimer.</span>
+<span class="c">#</span>
+<span class="c"># Redistributions in binary form must reproduce the above
copyright notice, this</span>
+<span class="c"># list of conditions and the following disclaimer in the
documentation and/or</span>
+<span class="c"># other materials provided with the distribution.</span>
+<span class="c"># </span>
+<span class="c"># Neither the name of the Purdue University nor the names
of its contributors</span>
+<span class="c"># may be used to endorse or promote products derived from
this software without</span>
+<span class="c"># specific prior written permission.</span>
+<span class="c"># </span>
+<span class="c"># THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS"</span>
+<span class="c"># AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
NOT LIMITED TO, THE</span>
+<span class="c"># IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE</span>
+<span class="c"># DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
CONTRIBUTORS BE LIABLE</span>
+<span class="c"># FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL</span>
+<span class="c"># DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR</span>
+<span class="c"># SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER</span>
+<span class="c"># CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY,</span>
+<span class="c"># OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE</span>
+<span class="c"># OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.</span>
+
+<span class="sd">"""Toplevel RosterCore API. This presents
entities to external consumers."""</span>
+
+<span class="n">__copyright__</span> <span class="o">=</span> <span
class="s">'Copyright (C) 2009, Purdue University'</span>
+<span class="n">__license__</span> <span class="o">=</span> <span
class="s">'BSD'</span>
+<span class="n">__version__</span> <span class="o">=</span> <span
class="s">'#TRUNK#'</span>
+
+
+<span class="kn">import</span> <span class="nn">tree_exporter</span>
+<span class="kn">from</span> <span class="nn">tree_exporter</span> <span
class="kn">import</span> <span class="n">BindTreeExport</span>
+<span class="kn">import</span> <span class="nn">config_lib</span>
+<span class="kn">from</span> <span class="nn">config_lib</span> <span
class="kn">import</span> <span class="n">ConfigLib</span>
+
+<span class="n">__all__</span> <span class="o">=</span> <span
class="p">[</span><span class="s">'ConfigLib'</span><span
class="p">,</span> <span class="s">'BindTreeExport'</span><span
class="p">,</span> <span class="s">'config_lib'</span><span
class="p">,</span> <span class="s">'tree_exporter'</span><span
class="p">]</span>
+
+
+<span class="c"># vi: set ai aw sw=2:</span>
+</pre></div>
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="../../search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../../genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ <li><a href="../index.html" >Module code</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2013, Purdue University.
+ Created using <a href="
http://sphinx-doc.org/">Sphinx</a> 1.2b1.
+ </div>
+ </body>
+</html>
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager/config_lib.html
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,888 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="
http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>roster_config_manager.config_lib — Roster Config Manager
v0.18 documentation</title>
+
+ <link rel="stylesheet" href="../../_static/default.css"
type="text/css" />
+ <link rel="stylesheet" href="../../_static/pygments.css"
type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: '../../',
+ VERSION: 'v0.18',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="../../_static/jquery.js"></script>
+ <script type="text/javascript"
src="../../_static/underscore.js"></script>
+ <script type="text/javascript"
src="../../_static/doctools.js"></script>
+ <link rel="top" title="Roster Config Manager v0.18 documentation"
href="../../index.html" />
+ <link rel="up" title="Module code" href="../index.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../../genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ <li><a href="../index.html" accesskey="U">Module code</a>
»</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <h1>Source code for roster_config_manager.config_lib</h1><div
class="highlight"><pre>
+<span class="c">#!/usr/bin/python</span>
+
+<span class="c"># Copyright (c) 2009, Purdue University</span>
+<span class="c"># All rights reserved.</span>
+<span class="c">#</span>
+<span class="c"># Redistribution and use in source and binary forms, with
or without</span>
+<span class="c"># modification, are permitted provided that the following
conditions are met:</span>
+<span class="c">#</span>
+<span class="c"># Redistributions of source code must retain the above
copyright notice, this</span>
+<span class="c"># list of conditions and the following disclaimer.</span>
+<span class="c">#</span>
+<span class="c"># Redistributions in binary form must reproduce the above
copyright notice, this</span>
+<span class="c"># list of conditions and the following disclaimer in the
documentation and/or</span>
+<span class="c"># other materials provided with the distribution.</span>
+<span class="c">#</span>
+<span class="c"># Neither the name of the Purdue University nor the names
of its contributors</span>
+<span class="c"># may be used to endorse or promote products derived from
this software without</span>
+<span class="c"># specific prior written permission.</span>
+<span class="c">#</span>
+<span class="c"># THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS"</span>
+<span class="c"># AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
NOT LIMITED TO, THE</span>
+<span class="c"># IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE</span>
+<span class="c"># DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
CONTRIBUTORS BE LIABLE</span>
+<span class="c"># FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL</span>
+<span class="c"># DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR</span>
+<span class="c"># SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER</span>
+<span class="c"># CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY,</span>
+<span class="c"># OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE</span>
+<span class="c"># OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.</span>
+
+<span class="sd">"""This module conains all of the logic to
check dns servers."""</span>
+
+<span class="n">__copyright__</span> <span class="o">=</span> <span
class="s">'Copyright (C) 2009, Purdue University'</span>
+<span class="n">__license__</span> <span class="o">=</span> <span
class="s">'BSD'</span>
+<span class="n">__version__</span> <span class="o">=</span> <span
class="s">'#TRUNK#'</span>
+
+<span class="kn">import</span> <span class="nn">ConfigParser</span>
+<span class="kn">import</span> <span class="nn">datetime</span>
+<span class="kn">import</span> <span class="nn">iscpy</span>
+<span class="kn">import</span> <span class="nn">os</span>
+<span class="kn">import</span> <span class="nn">roster_core</span>
+<span class="kn">import</span> <span class="nn">shutil</span>
+<span class="kn">import</span> <span class="nn">tarfile</span>
+
+<span class="kn">from</span> <span class="nn">fabric</span> <span
class="kn">import</span> <span class="n">api</span> <span
class="k">as</span> <span class="n">fabric_api</span>
+<span class="kn">from</span> <span class="nn">fabric</span> <span
class="kn">import</span> <span class="n">network</span> <span
class="k">as</span> <span class="n">fabric_network</span>
+<span class="kn">from</span> <span class="nn">fabric</span> <span
class="kn">import</span> <span class="n">state</span> <span
class="k">as</span> <span class="n">fabric_state</span>
+<span class="kn">from</span> <span class="nn">fabric.exceptions</span>
<span class="kn">import</span> <span class="n">NetworkError</span> <span
class="k">as</span> <span class="n">FabricNetworkError</span>
+<span class="kn">from</span> <span class="nn">roster_core</span> <span
class="kn">import</span> <span class="n">config</span>
+<span class="kn">from</span> <span class="nn">roster_core</span> <span
class="kn">import</span> <span class="n">errors</span>
+
+
+<span class="n">roster_core</span><span class="o">.</span><span
class="n">core</span><span class="o">.</span><span
class="n">CheckCoreVersionMatches</span><span class="p">(</span><span
class="n">__version__</span><span class="p">)</span>
+
+<div class="viewcode-block" id="ConfigManagerError"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigManagerError">[docs]</a><span
class="k">class</span> <span class="nc">ConfigManagerError</span><span
class="p">(</span><span class="n">errors</span><span
class="o">.</span><span class="n">CoreError</span><span class="p">):</span>
+ <span class="k">pass</span>
+</div>
+<div class="viewcode-block" id="ExporterNoFileError"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ExporterNoFileError">[docs]</a><span
class="k">class</span> <span class="nc">ExporterNoFileError</span><span
class="p">(</span><span class="n">ConfigManagerError</span><span
class="p">,</span> <span class="n">errors</span><span
class="o">.</span><span class="n">UserError</span><span class="p">):</span>
+ <span class="k">pass</span>
+</div>
+<div class="viewcode-block" id="ExporterFileError"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ExporterFileError">[docs]</a><span
class="k">class</span> <span class="nc">ExporterFileError</span><span
class="p">(</span><span class="n">ConfigManagerError</span><span
class="p">,</span> <span class="n">errors</span><span
class="o">.</span><span class="n">UserError</span><span class="p">):</span>
+ <span class="k">pass</span>
+</div>
+<div class="viewcode-block" id="ExporterFileNameError"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ExporterFileNameError">[docs]</a><span
class="k">class</span> <span class="nc">ExporterFileNameError</span><span
class="p">(</span><span class="n">ExporterFileError</span><span
class="p">):</span>
+ <span class="k">pass</span>
+</div>
+<div class="viewcode-block" id="ExporterListFileError"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ExporterListFileError">[docs]</a><span
class="k">class</span> <span class="nc">ExporterListFileError</span><span
class="p">(</span><span class="n">ExporterFileError</span><span
class="p">):</span>
+ <span class="k">pass</span>
+</div>
+<div class="viewcode-block" id="ExporterAuditIdError"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ExporterAuditIdError">[docs]</a><span
class="k">class</span> <span class="nc">ExporterAuditIdError</span><span
class="p">(</span><span class="n">ConfigManagerError</span><span
class="p">,</span> <span class="n">errors</span><span
class="o">.</span><span class="n">UserError</span><span class="p">):</span>
+ <span class="k">pass</span>
+</div>
+<div class="viewcode-block" id="ServerCheckError"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ServerCheckError">[docs]</a><span
class="k">class</span> <span class="nc">ServerCheckError</span><span
class="p">(</span><span class="n">ConfigManagerError</span><span
class="p">,</span> <span class="n">errors</span><span
class="o">.</span><span class="n">UserError</span><span class="p">):</span>
+ <span class="k">pass</span>
+</div>
+<div class="viewcode-block" id="QueryCheckError"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.QueryCheckError">[docs]</a><span
class="k">class</span> <span class="nc">QueryCheckError</span><span
class="p">(</span><span class="n">ConfigManagerError</span><span
class="p">,</span> <span class="n">errors</span><span
class="o">.</span><span class="n">UserError</span><span class="p">):</span>
+ <span class="k">pass</span>
+</div>
+<div class="viewcode-block" id="ConfigLib"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigLib">[docs]</a><span
class="k">class</span> <span class="nc">ConfigLib</span><span
class="p">(</span><span class="nb">object</span><span class="p">):</span>
+ <span class="sd">"""This class checks a DNS server for
the functionality required to push</span>
+<span class="sd"> zone files to it"""</span>
+
+ <span class="n">ToolList</span> <span class="o">=</span> <span
class="p">[</span><span class="s">'named-checkzone'</span><span
class="p">,</span> <span class="s">'named-compilezone'</span><span
class="p">,</span>
+ <span class="s">'named-checkconf'</span><span
class="p">,</span> <span class="s">'tar'</span><span
class="p">]</span>
+
+ <span class="n">COMMANDS_CONVERT_DICT</span> <span class="o">=</span>
<span class="p">{</span>
+ <span class="s">'check-dup-records'</span><span
class="p">:</span> <span class="p">{</span><span
class="s">'fail'</span><span class="p">:</span> <span
class="s">'fail'</span><span class="p">,</span> <span
class="s">'warn'</span><span class="p">:</span> <span
class="s">'warn'</span><span class="p">,</span> <span
class="s">'ignore'</span><span class="p">:</span> <span
class="s">'ignore'</span><span class="p">},</span>
+ <span class="s">'check-mx'</span><span
class="p">:</span> <span class="p">{</span><span
class="s">'fail'</span><span class="p">:</span> <span
class="s">'fail'</span><span class="p">,</span> <span
class="s">'warn'</span><span class="p">:</span> <span
class="s">'warn'</span><span class="p">,</span> <span
class="s">'ignore'</span><span class="p">:</span> <span
class="s">'ignore'</span><span class="p">},</span>
+ <span class="s">'check-mx-cname'</span><span
class="p">:</span> <span class="p">{</span><span
class="s">'fail'</span><span class="p">:</span> <span
class="s">'fail'</span><span class="p">,</span> <span
class="s">'warn'</span><span class="p">:</span> <span
class="s">'warn'</span><span class="p">,</span> <span
class="s">'ignore'</span><span class="p">:</span> <span
class="s">'ignore'</span><span class="p">},</span>
+ <span class="s">'check-srv-cname'</span><span
class="p">:</span> <span class="p">{</span><span
class="s">'fail'</span><span class="p">:</span> <span
class="s">'fail'</span><span class="p">,</span> <span
class="s">'warn'</span><span class="p">:</span> <span
class="s">'warn'</span><span class="p">,</span> <span
class="s">'ignore'</span><span class="p">:</span> <span
class="s">'ignore'</span><span class="p">},</span>
+ <span class="s">'check-wildcard'</span><span
class="p">:</span> <span class="p">{</span><span
class="s">'yes'</span><span class="p">:</span> <span
class="s">'warn'</span><span class="p">,</span> <span
class="s">'no'</span><span class="p">:</span> <span
class="s">'ignore'</span><span class="p">},</span>
+
+ <span class="s">'check-names'</span><span
class="p">:</span> <span class="p">{</span><span
class="s">'flag'</span><span class="p">:</span> <span
class="s">'-k'</span><span class="p">,</span> <span
class="s">'default'</span><span class="p">:</span> <span
class="s">'fail'</span><span class="p">},</span>
+ <span class="s">'check-integrity'</span><span
class="p">:</span> <span class="p">{</span><span
class="s">'yes'</span><span class="p">:</span> <span
class="s">'full'</span><span class="p">,</span> <span
class="s">'no'</span><span class="p">:</span> <span
class="s">'none'</span><span class="p">}</span>
+ <span class="p">}</span>
+
+ <span class="n">CHECKZONE_ARGS_DICT</span> <span class="o">=</span>
<span class="p">{</span>
+ <span class="s">'check-dup-records'</span><span
class="p">:</span> <span class="p">{</span><span
class="s">'flag'</span><span class="p">:</span> <span
class="s">'-r'</span><span class="p">,</span> <span
class="s">'arg'</span><span class="p">:</span> <span
class="s">'warn'</span><span class="p">},</span>
+ <span class="s">'check-mx'</span><span
class="p">:</span> <span class="p">{</span><span
class="s">'flag'</span><span class="p">:</span> <span
class="s">'-m'</span><span class="p">,</span> <span
class="s">'arg'</span><span class="p">:</span> <span
class="s">'warn'</span><span class="p">},</span>
+ <span class="s">'check-mx-cname'</span><span
class="p">:</span> <span class="p">{</span><span
class="s">'flag'</span><span class="p">:</span> <span
class="s">'-M'</span><span class="p">,</span> <span
class="s">'arg'</span><span class="p">:</span> <span
class="s">'warn'</span><span class="p">},</span>
+ <span class="s">'check-srv-cname'</span><span
class="p">:</span> <span class="p">{</span><span
class="s">'flag'</span><span class="p">:</span> <span
class="s">'-S'</span><span class="p">,</span> <span
class="s">'arg'</span><span class="p">:</span> <span
class="s">'warn'</span><span class="p">},</span>
+
+ <span class="s">'check-wildcard'</span><span
class="p">:</span> <span class="p">{</span><span
class="s">'flag'</span><span class="p">:</span> <span
class="s">'-W'</span><span class="p">,</span> <span
class="s">'arg'</span><span class="p">:</span> <span
class="s">'warn'</span><span class="p">},</span>
+ <span class="s">'check-names'</span><span
class="p">:</span> <span class="p">{</span><span
class="s">'flag'</span><span class="p">:</span> <span
class="s">'-k'</span><span class="p">,</span> <span
class="s">'arg'</span><span class="p">:</span> <span
class="s">'fail'</span><span class="p">},</span>
+ <span class="s">'check-integrity'</span><span
class="p">:</span> <span class="p">{</span><span
class="s">'flag'</span><span class="p">:</span> <span
class="s">'-i'</span><span class="p">,</span> <span
class="s">'arg'</span><span class="p">:</span> <span
class="s">'full'</span><span class="p">}</span>
+ <span class="p">}</span>
+
+ <span class="c">#Option clauses that we're interested in, and their
default BIND value.</span>
+ <span class="n">BIND_OPTION_CLAUSES</span> <span class="o">=</span>
<span class="p">{</span>
+ <span class="s">'check-dup-records'</span><span
class="p">:</span> <span class="s">'warn'</span><span
class="p">,</span>
+ <span class="s">'check-mx'</span><span
class="p">:</span> <span class="s">'warn'</span><span
class="p">,</span>
+ <span class="s">'check-mx-cname'</span><span
class="p">:</span> <span class="s">'warn'</span><span
class="p">,</span>
+ <span class="s">'check-srv-cname'</span><span
class="p">:</span> <span class="s">'warn'</span><span
class="p">,</span>
+ <span class="s">'check-wildcard'</span><span
class="p">:</span> <span class="s">'yes'</span><span
class="p">,</span>
+ <span class="s">'check-names'</span><span
class="p">:</span> <span class="s">'warn'</span><span
class="p">,</span>
+ <span class="s">'check-integrity'</span><span
class="p">:</span> <span class="s">'yes'</span><span
class="p">,</span>
+ <span class="s">'check-siblings'</span><span
class="p">:</span> <span class="s">'yes'</span>
+ <span class="p">}</span>
+
+ <span class="k">def</span> <span class="nf">__init__</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">config_file</span><span class="p">):</span>
+ <span class="sd">"""</span>
+<span class="sd"> """</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">config_file</span> <span class="o">=</span> <span
class="n">ConfigParser</span><span class="o">.</span><span
class="n">SafeConfigParser</span><span class="p">()</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">config_file</span><span class="o">.</span><span
class="n">read</span><span class="p">(</span><span
class="n">config_file</span><span class="p">)</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">config_file</span><span class="o">.</span><span
class="n">get</span><span class="p">(</span>
+ <span class="s">'exporter'</span><span class="p">,</span>
<span class="s">'root_config_dir'</span><span
class="p">)</span><span class="o">.</span><span
class="n">rstrip</span><span class="p">(</span><span
class="s">'/'</span><span class="p">)</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">config_file</span><span class="o">.</span><span
class="n">get</span><span class="p">(</span>
+ <span class="s">'exporter'</span><span class="p">,</span>
<span class="s">'backup_dir'</span><span class="p">)</span><span
class="o">.</span><span class="n">rstrip</span><span
class="p">(</span><span class="s">'/'</span><span class="p">)</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">max_threads</span> <span class="o">=</span> <span
class="nb">int</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">config_file</span><span class="o">.</span><span
class="n">get</span><span class="p">(</span>
+ <span class="s">'exporter'</span><span class="p">,</span>
<span class="s">'max_threads'</span><span class="p">))</span>
+
+<div class="viewcode-block" id="ConfigLib.UnTarDnsTree"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.UnTarDnsTree">[docs]</a>
<span class="k">def</span> <span class="nf">UnTarDnsTree</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">audit_log_id</span><span class="o">=</span><span
class="bp">None</span><span class="p">):</span>
+ <span class="sd">"""Uncompresses the compressed Dns
Tree to the </span>
+<span class="sd"> root configuration directory.</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> audit_log_id: id of the audit log of a compressed
dns tree</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> audit_log_id: int - the same as the input, unless
the input is None.</span>
+<span class="sd"> In which case, the most recent audit log will be
returned.</span>
+
+<span class="sd"> Raises:</span>
+<span class="sd"> ExporterFileError Compressed files will not be
extracted to /root/config.</span>
+<span class="sd"> """</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">audit_log_id</span> <span class="ow">is</span> <span
class="bp">None</span> <span class="p">):</span>
+ <span class="n">audit_log_id</span><span class="p">,</span> <span
class="n">filename</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">FindNewestDnsTreeFilename</span><span class="p">()</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">filename</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">FindDnsTreeFilename</span><span class="p">(</span><span
class="n">audit_log_id</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">filename</span> <span class="ow">is</span> <span
class="bp">None</span> <span class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ExporterNoFileError</span><span class="p">(</span><span
class="s">'Could not find a DNS tree for audit </span><span
class="si">%s</span><span class="s">.'</span> <span class="o">%</span>
+ <span class="n">audit_log_id</span><span
class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">os</span><span class="o">.</span><span class="n">path</span><span
class="o">.</span><span class="n">exists</span><span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">)</span> <span
class="p">):</span>
+ <span class="n">shutil</span><span class="o">.</span><span
class="n">rmtree</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">)</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">tar_file</span> <span class="o">=</span> <span
class="n">tarfile</span><span class="o">.</span><span
class="n">open</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">filename</span><span class="p">),</span> <span
class="s">'r:bz2'</span><span class="p">)</span>
+ <span class="n">tar_file</span><span class="o">.</span><span
class="n">extractall</span><span class="p">(</span><span
class="n">path</span><span class="o">=</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">)</span>
+ <span class="k">except</span> <span class="n">tarfile</span><span
class="o">.</span><span class="n">TarError</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ExporterFileError</span><span class="p">(</span><span
class="s">'Could not extract the DNS tree </span><span
class="si">%s</span><span class="s">/</span><span class="si">%s</span><span
class="s"> to </span><span class="si">%s</span><span
class="s">.'</span> <span class="o">%</span> <span class="p">(</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">filename</span><span class="p">,</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">))</span>
+ <span class="n">tar_file</span><span class="o">.</span><span
class="n">close</span><span class="p">()</span>
+ <span class="k">return</span> <span class="n">audit_log_id</span>
+</div>
+<div class="viewcode-block" id="ConfigLib.TarDnsTree"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.TarDnsTree">[docs]</a>
<span class="k">def</span> <span class="nf">TarDnsTree</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">audit_log_id</span><span class="p">):</span>
+ <span class="sd">"""Compresses the uncompressed Roster
Tree in the root configuration</span>
+<span class="sd"> directory to the compressed Roster Tree in the
Bind Directory.</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> audit_log_id: id of the audit log to a backup
tree</span>
+
+<span class="sd"> Raises:</span>
+<span class="sd"> ExporterAuditIdError No audit log id
supplied.</span>
+<span class="sd"> ExporterFileError Can not list files in /dir</span>
+<span class="sd"> """</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">audit_log_id</span> <span class="ow">is</span> <span
class="bp">None</span><span class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ExporterAuditIdError</span><span class="p">(</span><span
class="s">'No audit log id supplied.'</span><span class="p">)</span>
+ <span class="n">filename</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">FindDnsTreeFilename</span><span class="p">(</span><span
class="n">audit_log_id</span><span class="p">)</span>
+
+ <span class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="o">.</span><span
class="n">rstrip</span><span class="p">(</span><span
class="s">'/'</span><span class="p">)</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="o">.</span><span
class="n">rstrip</span><span class="p">(</span><span
class="s">'/'</span><span class="p">)</span>
+
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">dns_server_files</span> <span class="o">=</span>
<span class="n">os</span><span class="o">.</span><span
class="n">listdir</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">)</span>
+ <span class="k">except</span> <span class="ne">OSError</span><span
class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ExporterListFileError</span><span class="p">(</span><span
class="s">'Can not list files in </span><span class="si">%s</span><span
class="s">.'</span> <span class="o">%</span>
+ <span class="bp">self</span><span
class="o">.</span><span class="n">root_config_dir</span><span
class="p">)</span>
+ <span class="n">temp_tar_name</span> <span class="o">=</span> <span
class="s">'tmp_dns_tree.tar.bz2'</span>
+ <span class="n">tar_file</span> <span class="o">=</span> <span
class="n">tarfile</span><span class="o">.</span><span
class="n">open</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">temp_tar_name</span><span class="p">),</span>
+ <span class="s">'w:bz2'</span><span
class="p">)</span>
+
+ <span class="k">try</span><span class="p">:</span>
+ <span class="c"># Files in /root_config_dir</span>
+ <span class="c"># All directories</span>
+ <span class="k">for</span> <span class="n">server_dir</span> <span
class="ow">in</span> <span class="n">dns_server_files</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">os</span><span class="o">.</span><span class="n">path</span><span
class="o">.</span><span class="n">isdir</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">server_dir</span><span class="p">))</span> <span
class="p">):</span>
+ <span class="c">#Check next directory level for files, and
named</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">server_files</span> <span class="o">=</span>
<span class="n">os</span><span class="o">.</span><span
class="n">listdir</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span>
+ <span
class="n">server_dir</span><span class="p">))</span>
+ <span class="k">except</span> <span
class="ne">OSError</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ExporterListFileError</span><span class="p">(</span><span
class="s">'Can not list files in </span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">.'</span>
<span class="o">%</span>
+ <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">server_dir</span><span class="p">))</span>
+ <span class="c"># Files in /root_config_dir/server</span>
+ <span class="c"># One directory (named)</span>
+ <span class="c"># A few files (named_not_compiled.conf,
named_compiled.conf, </span>
+ <span class="c">#
server.info)</span>
+ <span class="k">for</span> <span class="n">server_file</span>
<span class="ow">in</span> <span class="n">server_files</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">os</span><span class="o">.</span><span class="n">path</span><span
class="o">.</span><span class="n">isdir</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">'</span> <span class="o">%</span>
<span class="p">(</span><span class="bp">self</span><span
class="o">.</span><span class="n">root_config_dir</span><span
class="p">,</span> <span class="n">server_dir</span><span class="p">,</span>
+ <span
class="n">server_file</span><span class="p">))</span> <span
class="p">):</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">named_files</span> <span
class="o">=</span> <span class="n">os</span><span class="o">.</span><span
class="n">listdir</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">'</span> <span class="o">%</span>
<span class="p">(</span><span class="bp">self</span><span
class="o">.</span><span class="n">root_config_dir</span><span
class="p">,</span>
+ <span class="n">server_dir</span><span
class="p">,</span> <span class="n">server_file</span><span
class="p">))</span>
+ <span class="k">except</span> <span
class="ne">OSError</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ExporterListFileError</span><span class="p">(</span><span
class="s">'Can not list files in </span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">.'</span> <span class="o">%</span>
+ <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">server_dir</span><span class="p">,</span> <span
class="n">server_file</span><span class="p">))</span>
+ <span class="c"># Files in
/root_config_dir/server/named</span>
+ <span class="c"># All directories</span>
+ <span class="k">for</span> <span class="n">view</span> <span
class="ow">in</span> <span class="n">named_files</span><span
class="p">:</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">__AddToTarFile__</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">'</span> <span class="o">%</span>
<span class="p">(</span><span class="n">server_dir</span><span
class="p">,</span> <span class="n">server_file</span><span
class="p">,</span>
+ <span class="n">view</span><span class="p">),</span>
<span class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">tar_file</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">view</span> <span class="o">==</span> <span
class="s">'
named.ca'</span> <span class="p">):</span>
+ <span class="k">continue</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">view_files</span> <span
class="o">=</span> <span class="n">os</span><span class="o">.</span><span
class="n">listdir</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">/</span><span class="si">%s</span><span
class="s">'</span> <span class="o">%</span> <span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span>
+ <span class="n">server_dir</span><span
class="p">,</span> <span class="n">server_file</span><span
class="p">,</span> <span class="n">view</span><span class="p">))</span>
+ <span class="k">except</span> <span
class="ne">OSError</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ExporterListFileError</span><span class="p">(</span><span
class="s">'Can not list files in '</span>
+ <span class="s">'</span><span
class="si">%s</span><span class="s">/</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">.'</span> <span class="o">%</span>
<span class="p">(</span><span class="bp">self</span><span
class="o">.</span><span class="n">root_config_dir</span><span
class="p">,</span> <span class="n">server_dir</span><span class="p">,</span>
+ <span
class="n">server_file</span><span class="p">,</span> <span
class="n">view</span><span class="p">))</span>
+
+ <span class="c"># Files in
/root_config_dir/server/named/view</span>
+ <span class="c"># All files</span>
+ <span class="k">for</span> <span class="n">zone</span>
<span class="ow">in</span> <span class="n">view_files</span><span
class="p">:</span>
+ <span class="bp">self</span><span
class="o">.</span><span class="n">__AddToTarFile__</span><span
class="p">(</span><span class="s">'</span><span
class="si">%s</span><span class="s">/</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">'</span> <span class="o">%</span>
<span class="p">(</span><span class="n">server_dir</span><span
class="p">,</span>
+ <span class="n">server_file</span><span
class="p">,</span> <span class="n">view</span><span class="p">,</span>
<span class="n">zone</span><span class="p">),</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">tar_file</span><span class="p">)</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">__AddToTarFile__</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="n">server_dir</span><span class="p">,</span> <span
class="n">server_file</span><span class="p">),</span>
+ <span class="bp">self</span><span
class="o">.</span><span class="n">root_config_dir</span><span
class="p">,</span> <span class="n">tar_file</span><span class="p">)</span>
+ <span class="k">except</span> <span
class="n">ExporterFileError</span><span class="p">:</span>
+ <span class="c"># Removes the temporary tarfile that was
created.</span>
+ <span class="n">tar_file</span><span class="o">.</span><span
class="n">close</span><span class="p">()</span>
+ <span class="n">os</span><span class="o">.</span><span
class="n">remove</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">temp_tar_name</span><span class="p">))</span>
+ <span class="k">raise</span>
+ <span class="n">tar_file</span><span class="o">.</span><span
class="n">close</span><span class="p">()</span>
+
+ <span class="c"># Temporarily moves the original audit file (if htere
was one)</span>
+ <span class="c"># in case something happens in transfering the new
DNS tree.</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">filename</span> <span class="ow">is</span> <span
class="ow">not</span> <span class="bp">None</span> <span class="p">):</span>
+ <span class="n">shutil</span><span class="o">.</span><span
class="n">move</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">filename</span><span class="p">),</span>
+ <span class="s">'</span><span
class="si">%s</span><span class="s">/</span><span class="si">%s</span><span
class="s">.tmp'</span> <span class="o">%</span> <span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">filename</span><span class="p">))</span>
+ <span class="n">date</span> <span class="o">=</span> <span
class="n">datetime</span><span class="o">.</span><span
class="n">datetime</span>
+ <span class="n">tar_file_name</span> <span class="o">=</span> <span
class="s">'dns_tree_</span><span class="si">%s</span><span
class="s">-</span><span class="si">%s</span><span
class="s">.tar.bz2'</span> <span class="o">%</span> <span
class="p">(</span>
+ <span class="n">date</span><span class="o">.</span><span
class="n">now</span><span class="p">()</span><span class="o">.</span><span
class="n">strftime</span><span class="p">(</span><span
class="s">'</span><span class="si">%d</span><span
class="s">_%m_%yT%H_%M'</span><span class="p">),</span> <span
class="n">audit_log_id</span><span class="p">)</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">shutil</span><span class="o">.</span><span
class="n">move</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">temp_tar_name</span><span class="p">),</span>
+ <span class="s">'</span><span
class="si">%s</span><span class="s">/</span><span class="si">%s</span><span
class="s">'</span> <span class="o">%</span> <span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">tar_file_name</span><span class="p">))</span>
+ <span class="k">except</span> <span class="n">shutil</span><span
class="o">.</span><span class="n">Error</span> <span class="k">as</span>
<span class="n">err</span><span class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">filename</span> <span class="ow">is</span> <span
class="ow">not</span> <span class="bp">None</span> <span class="p">):</span>
+ <span class="n">shutil</span><span class="o">.</span><span
class="n">move</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span
class="s">.tmp'</span> <span class="o">%</span> <span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">filename</span><span class="p">),</span>
+ <span class="s">'</span><span
class="si">%s</span><span class="s">/</span><span class="si">%s</span><span
class="s">'</span> <span class="o">%</span> <span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">filename</span><span class="p">))</span>
+ <span class="n">os</span><span class="o">.</span><span
class="n">remove</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">temp_tar_name</span><span class="p">))</span>
+ <span class="k">raise</span> <span
class="n">ExporterFileError</span><span class="p">(</span><span
class="s">'Unable to move the new DNS tree tar file to '</span>
+ <span class="s">'</span><span
class="si">%s</span><span class="s">/</span><span class="si">%s</span><span
class="s">.'</span> <span class="o">%</span> <span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">tar_file_name</span><span class="p">))</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">filename</span> <span class="ow">is</span> <span
class="ow">not</span> <span class="bp">None</span> <span class="p">):</span>
+ <span class="n">os</span><span class="o">.</span><span
class="n">remove</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span
class="s">.tmp'</span> <span class="o">%</span> <span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">filename</span><span class="p">))</span>
+ <span class="n">shutil</span><span class="o">.</span><span
class="n">rmtree</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">)</span>
+</div>
+ <span class="k">def</span> <span class="nf">__AddToTarFile__</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">filename</span><span class="p">,</span> <span
class="n">base_directory</span><span class="p">,</span> <span
class="n">tar_file</span><span class="p">):</span>
+ <span class="sd">"""Adds file object to tarfile
object</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> tarfile: tarfile object</span>
+<span class="sd"> file_name: path to file object</span>
+<span class="sd"> """</span>
+ <span class="n">tar_file</span><span class="o">.</span><span
class="n">add</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="n">base_directory</span><span class="p">,</span> <span
class="n">filename</span><span class="p">),</span> <span
class="n">arcname</span><span class="o">=</span><span
class="n">filename</span><span class="p">)</span>
+
+<div class="viewcode-block" id="ConfigLib.FindAllDnsServers"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.FindAllDnsServers">[docs]</a>
<span class="k">def</span> <span class="nf">FindAllDnsServers</span><span
class="p">(</span><span class="bp">self</span><span class="p">):</span>
+ <span class="sd">"""Finds and returns the names of all
the DNS servers that we are exporting.</span>
+
+<span class="sd"> This must be run after the bind trees are untarred to
the </span>
+<span class="sd"> root_config_dir."""</span>
+ <span class="n">server_list</span> <span class="o">=</span> <span
class="p">[]</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">server_list</span> <span class="o">=</span> <span
class="n">os</span><span class="o">.</span><span
class="n">listdir</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">)</span>
+ <span class="k">except</span> <span class="ne">OSError</span><span
class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ExporterNoFileError</span><span class="p">(</span><span
class="s">'DNS tree does not exist or has not been '</span>
+ <span class="s">'exported
yet.'</span><span class="p">)</span>
+ <span class="k">for</span> <span class="n">server</span> <span
class="ow">in</span> <span class="n">server_list</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">os</span><span
class="o">.</span><span class="n">path</span><span class="o">.</span><span
class="n">isdir</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">server</span><span class="p">))</span> <span class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ExporterFileError</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span class="s"> is not a
server; '</span>
+ <span class="s">'invalid DNS tree
format.'</span> <span class="o">%</span> <span
class="n">server</span><span class="p">)</span>
+ <span class="k">return</span> <span class="n">server_list</span>
+</div>
+<div class="viewcode-block" id="ConfigLib.FindDnsTreeFilename"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.FindDnsTreeFilename">[docs]</a>
<span class="k">def</span> <span class="nf">FindDnsTreeFilename</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">audit_log_id</span><span class="p">):</span>
+ <span class="sd">"""Finds the filename of the Dns Tree
from the audit log id given.</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> audit_log_id: id of the requested audit log.
</span>
+
+<span class="sd"> Raises:</span>
+<span class="sd"> ExporterAuditIdError: No audit log id
supplied.</span>
+<span class="sd"> ExporterFileError: Can not list files in
/dir.</span>
+<span class="sd"> ExporterFileError: DNS Tree file /dir/filename is
not named correctly.</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> string: filename of DNS Tree file</span>
+<span class="sd"> """</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">audit_log_id</span> <span class="ow">is</span> <span
class="bp">None</span> <span class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ExporterAuditIdError</span><span class="p">(</span><span
class="s">'No audit log id supplied.'</span><span class="p">)</span>
+ <span class="n">audit_log_id</span> <span class="o">=</span> <span
class="s">'</span><span class="si">%s</span><span
class="s">'</span> <span class="o">%</span> <span
class="n">audit_log_id</span>
+ <span class="n">file_list</span> <span class="o">=</span> <span
class="p">[]</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">file_list</span> <span class="o">=</span> <span
class="n">os</span><span class="o">.</span><span
class="n">listdir</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">)</span>
+ <span class="k">except</span> <span class="ne">OSError</span><span
class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ExporterListFileError</span><span class="p">(</span><span
class="s">'Can not list files in </span><span class="si">%s</span><span
class="s">.'</span> <span class="o">%</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">)</span>
+ <span class="n">dns_tree_filename</span> <span class="o">=</span>
<span class="bp">None</span>
+ <span class="k">for</span> <span class="n">file_name</span> <span
class="ow">in</span> <span class="n">file_list</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">file_name</span><span
class="o">.</span><span class="n">startswith</span><span
class="p">(</span><span class="s">'dns_tree'</span><span
class="p">)</span> <span class="p">):</span>
+ <span class="k">continue</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">file_audit_id</span> <span class="o">=</span>
<span class="nb">int</span><span class="p">(</span><span
class="n">file_name</span><span class="o">.</span><span
class="n">split</span><span class="p">(</span><span
class="s">'-'</span><span class="p">)[</span><span
class="mi">1</span><span class="p">]</span><span class="o">.</span><span
class="n">split</span><span class="p">(</span><span
class="s">'.'</span><span class="p">)[</span><span
class="mi">0</span><span class="p">])</span>
+ <span class="k">except</span> <span
class="ne">IndexError</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ExporterFileNameError</span><span class="p">(</span><span
class="s">'DNS Tree file </span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s"> is not named
'</span>
+ <span class="s">'correctly.'</span> <span
class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">file_name</span><span class="p">))</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">audit_log_id</span><span class="o">==</span><span
class="s">'</span><span class="si">%s</span><span
class="s">'</span> <span class="o">%</span> <span
class="n">file_audit_id</span> <span class="p">):</span>
+ <span class="n">dns_tree_filename</span> <span class="o">=</span>
<span class="n">file_name</span>
+ <span class="n">newest</span> <span class="o">=</span> <span
class="n">file_audit_id</span>
+ <span class="k">break</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">dns_tree_filename</span> <span class="o">=</span>
<span class="bp">None</span>
+ <span class="k">return</span> <span class="n">dns_tree_filename</span>
+</div>
+<div class="viewcode-block" id="ConfigLib.FindNewestDnsTreeFilename"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.FindNewestDnsTreeFilename">[docs]</a>
<span class="k">def</span> <span
class="nf">FindNewestDnsTreeFilename</span><span class="p">(</span><span
class="bp">self</span><span class="p">):</span>
+ <span class="sd">"""Finds the filename of the newest
Dns Tree file in the backup directory.</span>
+
+<span class="sd"> Raises:</span>
+<span class="sd"> ExporterListFileError: Can not list files in
/dir.</span>
+<span class="sd"> ExporterNoFileError: Backup directory /dir does not
contain any files</span>
+<span class="sd"> or directories.</span>
+<span class="sd"> ExporterFileNameError: DNS Tree file /dir/filename
is not named correctly.</span>
+<span class="sd"> ExporterNoFileError: Could not find a DNS Tree file
in /dir.</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> tuple: id of audit log, name of Dns Tree file for
audit log id</span>
+<span class="sd"> """</span>
+ <span class="n">file_list</span> <span class="o">=</span> <span
class="p">[]</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">file_list</span> <span class="o">=</span> <span
class="n">os</span><span class="o">.</span><span
class="n">listdir</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">)</span>
+ <span class="k">except</span> <span class="ne">OSError</span><span
class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ExporterListFileError</span><span class="p">(</span><span
class="s">'Can not list files in </span><span class="si">%s</span><span
class="s">.'</span> <span class="o">%</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">file_list</span> <span class="o">==</span> <span
class="p">[]</span> <span class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ExporterNoFileError</span><span class="p">(</span><span
class="s">'Backup directory </span><span class="si">%s</span><span
class="s"> does not contain any files'</span>
+ <span class="s">' or
directories.'</span> <span class="o">%</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">)</span>
+ <span class="n">newest</span> <span class="o">=</span> <span
class="o">-</span><span class="mi">1</span>
+ <span class="n">newest_file_name</span> <span class="o">=</span> <span
class="bp">None</span>
+ <span class="k">for</span> <span class="n">file_name</span> <span
class="ow">in</span> <span class="n">file_list</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">file_name</span><span
class="o">.</span><span class="n">startswith</span><span
class="p">(</span><span class="s">'dns_tree'</span><span
class="p">)</span> <span class="p">):</span>
+ <span class="k">continue</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="nb">id</span> <span class="o">=</span> <span
class="nb">int</span><span class="p">(</span><span
class="n">file_name</span><span class="o">.</span><span
class="n">split</span><span class="p">(</span><span
class="s">'-'</span><span class="p">)[</span><span
class="mi">1</span><span class="p">]</span><span class="o">.</span><span
class="n">split</span><span class="p">(</span><span
class="s">'.'</span><span class="p">)[</span><span
class="mi">0</span><span class="p">])</span>
+ <span class="k">except</span> <span
class="ne">IndexError</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ExporterFileNameError</span><span class="p">(</span><span
class="s">'DNS Tree file </span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s"> is not named
'</span>
+ <span
class="s">'correctly.'</span> <span class="o">%</span> <span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">file_name</span><span class="p">))</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="nb">id</span> <span class="o">></span> <span
class="n">newest</span> <span class="p">):</span>
+ <span class="n">newest_file_name</span> <span class="o">=</span>
<span class="n">file_name</span>
+ <span class="n">newest</span> <span class="o">=</span> <span
class="nb">id</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">newest_file_name</span> <span class="ow">is</span> <span
class="bp">None</span> <span class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ExporterNoFileError</span><span class="p">(</span><span
class="s">'Could not find a DNS Tree file in </span><span
class="si">%s</span><span class="s">.'</span> <span class="o">%</span>
+ <span class="bp">self</span><span
class="o">.</span><span class="n">backup_dir</span><span class="p">)</span>
+ <span class="k">return</span> <span class="n">newest</span><span
class="p">,</span> <span class="n">newest_file_name</span>
+</div>
+<div class="viewcode-block" id="ConfigLib.GetDnsServerInfo"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.GetDnsServerInfo">[docs]</a>
<span class="k">def</span> <span class="nf">GetDnsServerInfo</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">dns_server</span><span class="p">):</span>
+ <span class="sd">"""Gets the information about a DNS
server from the
dns_server.info file</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> dns_server: name of DNS server</span>
+
+<span class="sd"> Raises:</span>
+<span class="sd"> ExporterNoFileError: DNS tree does not exist or has
not been </span>
+<span class="sd"> exported yet.</span>
+<span class="sd"> ServerCheckError: DNS server server_name does not
exist.</span>
+<span class="sd"> ServerCheckError: DNS server metadata file does not
exist.</span>
+<span class="sd"> ServerCheckError: DNS server metadata file
incorrectly written.</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> dict: {'server_info': {</span>
+<span class="sd"> 'server_name':
'university.lcl',</span>
+<span class="sd"> 'server_user':
'user',</span>
+<span class="sd"> 'bind_dir':
'/etc/bind/',</span>
+<span class="sd"> 'test_dir':
'/etc/bind/test/',</span>
+<span class="sd"> 'bind_version':
'UNKNOWN'},</span>
+<span class="sd"> 'tools': {</span>
+<span class="sd"> 'tar': 'True'}}</span>
+<span class="sd"> """</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">os</span><span
class="o">.</span><span class="n">path</span><span class="o">.</span><span
class="n">exists</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">)</span> <span
class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ExporterNoFileError</span><span class="p">(</span><span
class="s">'DNS tree does not exist or has not been '</span>
+ <span class="s">'exported
yet.'</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">os</span><span
class="o">.</span><span class="n">path</span><span class="o">.</span><span
class="n">exists</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">))</span> <span
class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'DNS server </span><span class="si">%s</span><span class="s">
does not exist.'</span> <span class="o">%</span> <span
class="n">dns_server</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">os</span><span
class="o">.</span><span class="n">path</span><span class="o">.</span><span
class="n">exists</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">.info'</span> <span
class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">,</span>
+ <span
class="n">dns_server</span><span class="p">))</span> <span
class="p">):</span>
+ <span class="c"># Right now we raise if the
server.info file
doesn't exist.</span>
+ <span class="c"># Should we just return an empty dictionary
{} ?</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'DNS server metadata file does not exist.'</span><span
class="p">)</span>
+ <span class="n">dns_server_info</span> <span class="o">=</span> <span
class="n">ConfigParser</span><span class="o">.</span><span
class="n">SafeConfigParser</span><span class="p">()</span>
+ <span class="n">dns_server_info</span><span class="o">.</span><span
class="n">read</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">.info'</span> <span
class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">,</span>
+ <span
class="n">dns_server</span><span class="p">))</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">dns_server_info</span><span
class="o">.</span><span class="n">has_section</span><span
class="p">(</span><span class="s">'server_info'</span><span
class="p">)</span> <span class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'DNS server metadata file incorrectly
written.'</span><span class="p">)</span>
+ <span class="n">dns_server_options</span> <span class="o">=</span>
<span class="n">dns_server_info</span><span class="o">.</span><span
class="n">options</span><span class="p">(</span><span
class="s">'server_info'</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'server_name'</span> <span class="ow">not</span> <span
class="ow">in</span> <span class="n">dns_server_options</span> <span
class="ow">or</span>
+ <span class="n">dns_server_info</span><span
class="o">.</span><span class="n">get</span><span class="p">(</span><span
class="s">'server_info'</span><span class="p">,</span><span
class="s">'server_name'</span><span class="p">)</span> <span
class="o">!=</span> <span class="n">dns_server</span> <span
class="ow">or</span>
+ <span class="s">'server_user'</span> <span
class="ow">not</span> <span class="ow">in</span> <span
class="n">dns_server_options</span> <span class="ow">or</span>
+ <span class="s">'bind_dir'</span> <span
class="ow">not</span> <span class="ow">in</span> <span
class="n">dns_server_options</span> <span class="ow">or</span>
+ <span class="s">'test_dir'</span> <span
class="ow">not</span> <span class="ow">in</span> <span
class="n">dns_server_options</span> <span class="ow">or</span>
+ <span class="s">'bind_version'</span> <span
class="ow">not</span> <span class="ow">in</span> <span
class="n">dns_server_options</span> <span class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'DNS server metadata file incorrectly
written.'</span><span class="p">)</span>
+
+ <span class="n">server_info_dict</span> <span class="o">=</span> <span
class="p">{}</span>
+ <span class="k">for</span> <span class="n">section</span> <span
class="ow">in</span> <span class="n">dns_server_info</span><span
class="o">.</span><span class="n">sections</span><span class="p">():</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">section</span> <span class="ow">not</span> <span
class="ow">in</span> <span class="n">server_info_dict</span> <span
class="p">):</span>
+ <span class="n">server_info_dict</span><span
class="p">[</span><span class="n">section</span><span class="p">]</span>
<span class="o">=</span> <span class="p">{}</span>
+ <span class="k">for</span> <span class="n">option</span> <span
class="ow">in</span> <span class="n">dns_server_info</span><span
class="o">.</span><span class="n">options</span><span
class="p">(</span><span class="n">section</span><span class="p">):</span>
+ <span class="n">value</span> <span class="o">=</span> <span
class="n">dns_server_info</span><span class="o">.</span><span
class="n">get</span><span class="p">(</span><span
class="n">section</span><span class="p">,</span> <span
class="n">option</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">value</span><span class="o">.</span><span
class="n">lower</span><span class="p">()</span> <span class="o">==</span>
<span class="s">'true'</span> <span class="p">):</span>
+ <span class="n">server_info_dict</span><span
class="p">[</span><span class="n">section</span><span
class="p">][</span><span class="n">option</span><span class="p">]</span>
<span class="o">=</span> <span class="bp">True</span>
+ <span class="k">elif</span><span class="p">(</span> <span
class="n">value</span><span class="o">.</span><span
class="n">lower</span><span class="p">()</span> <span class="o">==</span>
<span class="s">'false'</span> <span class="p">):</span>
+ <span class="n">server_info_dict</span><span
class="p">[</span><span class="n">section</span><span
class="p">][</span><span class="n">option</span><span class="p">]</span>
<span class="o">=</span> <span class="bp">False</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">server_info_dict</span><span
class="p">[</span><span class="n">section</span><span
class="p">][</span><span class="n">option</span><span class="p">]</span>
<span class="o">=</span> <span class="n">value</span>
+
+ <span class="k">return</span> <span class="n">server_info_dict</span>
+</div>
+<div class="viewcode-block" id="ConfigLib.WriteDnsServerInfo"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.WriteDnsServerInfo">[docs]</a>
<span class="k">def</span> <span class="nf">WriteDnsServerInfo</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">server_info_dict</span><span class="p">):</span>
+ <span class="sd">"""Writes the information about a DNS
server to the
dns_server.info file.</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> server_info_dict: dict of the DNS server's
information</span>
+<span class="sd"> Example:</span>
+<span class="sd"> {'server_info': {</span>
+<span class="sd"> 'server_name':
'university.lcl',</span>
+<span class="sd"> 'server_user':
'user',</span>
+<span class="sd"> 'bind_dir':
'/etc/bind/',</span>
+<span class="sd"> 'test_dir':
'/etc/bind/test/',</span>
+<span class="sd"> 'bind_version':
'UNKNOWN'},</span>
+<span class="sd"> 'tools': {</span>
+<span class="sd"> 'tar':
'True'}}</span>
+
+<span class="sd"> Raises:</span>
+<span class="sd"> ExporterNoFileError: DNS tree does not exist or has
not been</span>
+<span class="sd"> exported yet.</span>
+<span class="sd"> ServerCheckError: DNS server server_name does not
exist.</span>
+<span class="sd"> ServerCheckError: Invalid DNS server information
supplied.</span>
+<span class="sd"> """</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'server_info'</span> <span class="ow">not</span> <span
class="ow">in</span> <span class="n">server_info_dict</span> <span
class="ow">or</span>
+ <span class="s">'server_name'</span> <span
class="ow">not</span> <span class="ow">in</span> <span
class="n">server_info_dict</span><span class="p">[</span><span
class="s">'server_info'</span><span class="p">]</span> <span
class="ow">or</span>
+ <span class="s">'server_user'</span> <span
class="ow">not</span> <span class="ow">in</span> <span
class="n">server_info_dict</span><span class="p">[</span><span
class="s">'server_info'</span><span class="p">]</span> <span
class="ow">or</span>
+ <span class="s">'bind_dir'</span> <span
class="ow">not</span> <span class="ow">in</span> <span
class="n">server_info_dict</span><span class="p">[</span><span
class="s">'server_info'</span><span class="p">]</span> <span
class="ow">or</span>
+ <span class="s">'test_dir'</span> <span
class="ow">not</span> <span class="ow">in</span> <span
class="n">server_info_dict</span><span class="p">[</span><span
class="s">'server_info'</span><span class="p">]</span> <span
class="ow">or</span>
+ <span class="s">'bind_version'</span> <span
class="ow">not</span> <span class="ow">in</span> <span
class="n">server_info_dict</span><span class="p">[</span><span
class="s">'server_info'</span><span class="p">]</span> <span
class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'Invalid DNS server information supplied.'</span><span
class="p">)</span>
+ <span class="n">dns_server</span> <span class="o">=</span> <span
class="n">server_info_dict</span><span class="p">[</span><span
class="s">'server_info'</span><span class="p">][</span><span
class="s">'server_name'</span><span class="p">]</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">os</span><span
class="o">.</span><span class="n">path</span><span class="o">.</span><span
class="n">exists</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">)</span> <span
class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ExporterNoFileError</span><span class="p">(</span><span
class="s">'DNS tree does not exist or has not been '</span>
+ <span class="s">'exported
yet.'</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">os</span><span
class="o">.</span><span class="n">path</span><span class="o">.</span><span
class="n">exists</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">))</span> <span
class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'DNS server </span><span class="si">%s</span><span class="s">
does not exist.'</span> <span class="o">%</span> <span
class="n">dns_server</span><span class="p">)</span>
+
+ <span class="n">dns_server_info</span> <span class="o">=</span> <span
class="n">ConfigParser</span><span class="o">.</span><span
class="n">SafeConfigParser</span><span class="p">()</span>
+ <span class="k">for</span> <span class="n">section</span> <span
class="ow">in</span> <span class="n">server_info_dict</span><span
class="p">:</span>
+ <span class="n">dns_server_info</span><span class="o">.</span><span
class="n">add_section</span><span class="p">(</span><span
class="n">section</span><span class="p">)</span>
+ <span class="k">for</span> <span class="n">option</span> <span
class="ow">in</span> <span class="n">server_info_dict</span><span
class="p">[</span><span class="n">section</span><span class="p">]:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">server_info_dict</span><span class="p">[</span><span
class="n">section</span><span class="p">][</span><span
class="n">option</span><span class="p">]</span> <span class="o">==</span>
<span class="bp">True</span> <span class="p">):</span>
+ <span class="n">dns_server_info</span><span
class="o">.</span><span class="n">set</span><span class="p">(</span><span
class="n">section</span><span class="p">,</span> <span
class="n">option</span><span class="p">,</span> <span
class="s">'true'</span><span class="p">)</span>
+ <span class="k">elif</span><span class="p">(</span> <span
class="n">server_info_dict</span><span class="p">[</span><span
class="n">section</span><span class="p">][</span><span
class="n">option</span><span class="p">]</span> <span class="o">==</span>
<span class="bp">False</span> <span class="p">):</span>
+ <span class="n">dns_server_info</span><span
class="o">.</span><span class="n">set</span><span class="p">(</span><span
class="n">section</span><span class="p">,</span> <span
class="n">option</span><span class="p">,</span> <span
class="s">'false'</span><span class="p">)</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">dns_server_info</span><span
class="o">.</span><span class="n">set</span><span class="p">(</span><span
class="n">section</span><span class="p">,</span> <span
class="n">option</span><span class="p">,</span>
+ <span class="n">server_info_dict</span><span
class="p">[</span><span class="n">section</span><span
class="p">][</span><span class="n">option</span><span class="p">])</span>
+ <span class="n">dns_server_info_file</span> <span class="o">=</span>
<span class="nb">open</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">.info'</span> <span
class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span>
+ <span
class="n">dns_server</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">),</span> <span
class="s">'w'</span><span class="p">)</span>
+ <span class="n">dns_server_info</span><span class="o">.</span><span
class="n">write</span><span class="p">(</span><span
class="n">dns_server_info_file</span><span class="p">)</span>
+ <span class="n">dns_server_info_file</span><span
class="o">.</span><span class="n">close</span><span class="p">()</span>
+ </div>
+<div class="viewcode-block" id="ConfigLib.CheckDnsServer"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.CheckDnsServer">[docs]</a>
<span class="k">def</span> <span class="nf">CheckDnsServer</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">dns_server</span><span class="p">,</span> <span
class="n">tools_check_list</span><span class="p">):</span>
+ <span class="sd">"""Checks a DNS server for connection,
that necessary directories are</span>
+<span class="sd"> created, that BIND is installed, and availability of
tools.</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> dns_server: name of DNS server to check</span>
+<span class="sd"> tools_check_list: list of tools to check</span>
+
+<span class="sd"> Raises:</span>
+<span class="sd"> ExporterFileError: Can not list files in
/dir.</span>
+<span class="sd"> ServerCheckError: DNS server 1.2.3.4 does not
exist.</span>
+<span class="sd"> ServerCheckError: DNS server metadata file
incorrectly written or does</span>
+<span class="sd"> not exist.</span>
+<span class="sd"> ServerCheckError: Can not connect to 1.2.3.4 via
SSH.</span>
+<span class="sd"> ServerCheckError: Unable to run 'named' on
1.2.3.4. Is BIND installed</span>
+<span class="sd"> on the remote server?</span>
+<span class="sd"> ServerCheckError: The remote test directory
/etc/bind/test does not exist</span>
+<span class="sd"> or the user someone does not have
permission.</span>
+<span class="sd"> ServerCheckError: The remote BIND directory
/etc/bind does not exist or</span>
+<span class="sd"> the user someone does not have
permission.</span>
+<span class="sd"> """</span>
+ <span class="k">for</span> <span class="n">output</span> <span
class="ow">in</span> <span class="n">fabric_state</span><span
class="o">.</span><span class="n">output</span><span class="p">:</span>
+ <span class="n">fabric_state</span><span class="o">.</span><span
class="n">output</span><span class="p">[</span><span
class="n">output</span><span class="p">]</span> <span class="o">=</span>
<span class="bp">False</span>
+
+ <span class="n">dns_server_data</span> <span class="o">=</span> <span
class="p">{}</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">dns_servers</span> <span class="o">=</span> <span
class="n">os</span><span class="o">.</span><span
class="n">listdir</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">)</span>
+ <span class="k">except</span> <span class="ne">OSError</span><span
class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ExporterListFileError</span><span class="p">(</span><span
class="s">'Can not list files in </span><span class="si">%s</span><span
class="s">.'</span> <span class="o">%</span>
+ <span class="bp">self</span><span
class="o">.</span><span class="n">root_config_dir</span><span
class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">dns_server</span> <span class="ow">not</span> <span
class="ow">in</span> <span class="n">dns_servers</span> <span
class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'DNS server </span><span class="si">%s</span><span class="s">
does not exist.'</span> <span class="o">%</span> <span
class="n">dns_server</span><span class="p">)</span>
+
+ <span class="n">dns_server_info</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">GetDnsServerInfo</span><span class="p">(</span><span
class="n">dns_server</span><span class="p">)</span>
+ <span class="n">ssh_host</span> <span class="o">=</span> <span
class="s">'</span><span class="si">%s</span><span
class="s">@</span><span class="si">%s</span><span class="s">:22'</span>
<span class="o">%</span> <span class="p">(</span><span
class="n">dns_server_info</span><span class="p">[</span><span
class="s">'server_info'</span><span class="p">][</span><span
class="s">'server_user'</span><span class="p">],</span>
+ <span class="n">dns_server_info</span><span
class="p">[</span><span class="s">'server_info'</span><span
class="p">][</span><span class="s">'server_name'</span><span
class="p">])</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">fabric_api</span><span class="o">.</span><span
class="n">env</span><span class="o">.</span><span
class="n">warn_only</span> <span class="o">=</span> <span
class="bp">False</span>
+
+ <span class="c"># Testing for server connection through SSH</span>
+ <span class="n">fabric_api</span><span class="o">.</span><span
class="n">env</span><span class="o">.</span><span
class="n">host_string</span> <span class="o">=</span> <span
class="n">ssh_host</span>
+ <span class="n">test_return</span> <span class="o">=</span> <span
class="n">fabric_api</span><span class="o">.</span><span
class="n">run</span><span class="p">(</span><span class="s">'echo
"Test"'</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">test_return</span> <span class="o">!=</span> <span
class="s">'Test'</span> <span class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'Can not connect to </span><span class="si">%s</span><span
class="s"> via SSH.'</span> <span class="o">%</span> <span
class="n">dns_server</span><span class="p">)</span>
+
+ <span class="n">fabric_api</span><span class="o">.</span><span
class="n">env</span><span class="o">.</span><span
class="n">warn_only</span> <span class="o">=</span> <span
class="bp">True</span>
+
+ <span class="c"># Testing for BIND installation</span>
+ <span class="n">result</span> <span class="o">=</span> <span
class="n">fabric_api</span><span class="o">.</span><span
class="n">run</span><span class="p">(</span><span class="s">'named
-v'</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'command not found'</span> <span class="ow">in</span>
<span class="n">result</span> <span class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'Unable to run </span><span class="se">\'</span><span
class="s">named</span><span class="se">\'</span><span class="s"> on
</span><span class="si">%s</span><span class="s">. Is BIND '</span>
+ <span class="s">'installed on the
remote server?'</span> <span class="o">%</span> <span
class="n">dns_server</span><span class="p">)</span>
+ <span class="n">dns_server_info</span><span class="p">[</span><span
class="s">'server_info'</span><span class="p">][</span><span
class="s">'bind_version'</span><span class="p">]</span> <span
class="o">=</span> <span class="n">result</span><span
class="o">.</span><span class="n">lstrip</span><span
class="p">(</span><span class="s">'BIND '</span><span
class="p">)</span>
+
+ <span class="c"># Testing for directories</span>
+ <span class="n">result</span> <span class="o">=</span> <span
class="n">fabric_api</span><span class="o">.</span><span
class="n">run</span><span class="p">(</span><span class="s">'ls
</span><span class="si">%s</span><span class="s">'</span> <span
class="o">%</span>
+ <span class="n">dns_server_info</span><span
class="p">[</span><span class="s">'server_info'</span><span
class="p">][</span><span class="s">'bind_dir'</span><span
class="p">])</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'No such file or directory'</span> <span
class="ow">in</span> <span class="n">result</span> <span class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'The remote BIND directory </span><span
class="si">%s</span><span class="s"> does not exist '</span>
+ <span class="s">'or the user </span><span
class="si">%s</span><span class="s"> does not have permission.'</span>
<span class="o">%</span>
+ <span class="p">(</span><span
class="n">dns_server_info</span><span class="p">[</span><span
class="s">'server_info'</span><span class="p">][</span><span
class="s">'bind_dir'</span><span class="p">],</span>
+ <span class="n">dns_server_info</span><span
class="p">[</span><span class="s">'server_info'</span><span
class="p">][</span><span class="s">'server_user'</span><span
class="p">]))</span>
+
+ <span class="n">result</span> <span class="o">=</span> <span
class="n">fabric_api</span><span class="o">.</span><span
class="n">run</span><span class="p">(</span><span class="s">'ls
</span><span class="si">%s</span><span class="s">'</span> <span
class="o">%</span>
+ <span class="n">dns_server_info</span><span
class="p">[</span><span class="s">'server_info'</span><span
class="p">][</span><span class="s">'test_dir'</span><span
class="p">])</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'No such file or directory'</span> <span
class="ow">in</span> <span class="n">result</span> <span class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'The remote test directory </span><span
class="si">%s</span><span class="s"> does not exist '</span>
+ <span class="s">'or the user </span><span
class="si">%s</span><span class="s"> does not have permission.'</span>
<span class="o">%</span>
+ <span class="p">(</span><span
class="n">dns_server_info</span><span class="p">[</span><span
class="s">'server_info'</span><span class="p">][</span><span
class="s">'test_dir'</span><span class="p">],</span>
+ <span class="n">dns_server_info</span><span
class="p">[</span><span class="s">'server_info'</span><span
class="p">][</span><span class="s">'server_user'</span><span
class="p">]))</span>
+
+ <span class="c"># Testing for tools</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'tools'</span> <span class="ow">not</span> <span
class="ow">in</span> <span class="n">dns_server_info</span> <span
class="p">):</span>
+ <span class="n">dns_server_info</span><span
class="p">[</span><span class="s">'tools'</span><span
class="p">]</span> <span class="o">=</span> <span class="p">{}</span>
+ <span class="k">for</span> <span class="n">tool</span> <span
class="ow">in</span> <span class="n">tools_check_list</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">tool</span> <span class="ow">not</span> <span
class="ow">in</span> <span class="bp">self</span><span
class="o">.</span><span class="n">ToolList</span> <span class="p">):</span>
+ <span class="k">raise</span> <span class="n">errors</span><span
class="o">.</span><span class="n">FunctionError</span><span
class="p">(</span><span class="s">'Provided tool </span><span
class="si">%s</span><span class="s"> is not in tool list.'</span>
+ <span class="o">%</span> <span
class="n">tool</span><span class="p">)</span>
+ <span class="n">result</span> <span class="o">=</span> <span
class="n">fabric_api</span><span class="o">.</span><span
class="n">run</span><span class="p">(</span><span
class="n">tool</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'command not found'</span> <span class="ow">in</span>
<span class="n">result</span> <span class="p">):</span>
+ <span class="n">dns_server_info</span><span
class="p">[</span><span class="s">'tools'</span><span
class="p">][</span><span class="n">tool</span><span class="p">]</span>
<span class="o">=</span> <span class="bp">False</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">dns_server_info</span><span
class="p">[</span><span class="s">'tools'</span><span
class="p">][</span><span class="n">tool</span><span class="p">]</span>
<span class="o">=</span> <span class="bp">True</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">WriteDnsServerInfo</span><span class="p">(</span><span
class="n">dns_server_info</span><span class="p">)</span>
+ <span class="k">except</span> <span
class="n">FabricNetworkError</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'Could not connect to </span><span class="si">%s</span><span
class="s"> via SSH.'</span> <span class="o">%</span> <span
class="n">dns_server</span><span class="p">)</span>
+ <span class="k">except</span> <span class="n">ConfigParser</span><span
class="o">.</span><span class="n">Error</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'Can not write to </span><span class="si">%s</span><span
class="s"> info file.'</span> <span class="o">%</span> <span
class="n">dns_server</span><span class="p">)</span>
+ <span class="k">finally</span><span class="p">:</span>
+ <span class="n">fabric_network</span><span class="o">.</span><span
class="n">disconnect_all</span><span class="p">()</span>
+</div>
+<div class="viewcode-block" id="ConfigLib.TarDnsBindFiles"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.TarDnsBindFiles">[docs]</a>
<span class="k">def</span> <span class="nf">TarDnsBindFiles</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">dns_server</span><span class="p">):</span>
+ <span class="sd">"""Tars the BIND tree for a DNS
server.</span>
+<span class="sd"> </span>
+<span class="sd"> Inputs:</span>
+<span class="sd"> dns_server: name of dns_server</span>
+<span class="sd"> """</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">os</span><span
class="o">.</span><span class="n">path</span><span class="o">.</span><span
class="n">exists</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">)</span> <span
class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ExporterNoFileError</span><span class="p">(</span><span
class="s">'DNS tree does not exist or has not been '</span>
+ <span class="s">'exported
yet.'</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">os</span><span
class="o">.</span><span class="n">path</span><span class="o">.</span><span
class="n">exists</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">))</span> <span
class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'DNS server </span><span class="si">%s</span><span class="s">
does not exist.'</span> <span class="o">%</span> <span
class="n">dns_server</span><span class="p">)</span>
+ <span class="n">dns_tar_file</span> <span class="o">=</span> <span
class="n">tarfile</span><span class="o">.</span><span
class="n">open</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">.tar.bz2'</span> <span
class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span>
+ <span class="n">dns_server</span><span class="p">,</span><span
class="n">dns_server</span><span class="p">),</span> <span
class="s">'w:bz2'</span><span class="p">)</span>
+
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">server_files</span> <span class="o">=</span> <span
class="n">os</span><span class="o">.</span><span
class="n">listdir</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">))</span>
+ <span class="k">for</span> <span class="n">server_file</span> <span
class="ow">in</span> <span class="n">server_files</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">os</span><span class="o">.</span><span class="n">path</span><span
class="o">.</span><span class="n">isdir</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">'</span> <span class="o">%</span>
<span class="p">(</span><span class="bp">self</span><span
class="o">.</span><span class="n">root_config_dir</span><span
class="p">,</span> <span class="n">dns_server</span><span class="p">,</span>
+ <span
class="n">server_file</span><span class="p">))</span> <span
class="p">):</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">named_files</span> <span class="o">=</span>
<span class="n">os</span><span class="o">.</span><span
class="n">listdir</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">'</span> <span class="o">%</span>
<span class="p">(</span><span class="bp">self</span><span
class="o">.</span><span class="n">root_config_dir</span><span
class="p">,</span>
+ <span class="n">dns_server</span><span class="p">,</span>
<span class="n">server_file</span><span class="p">))</span>
+ <span class="k">except</span> <span
class="ne">OSError</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ExporterListFileError</span><span class="p">(</span><span
class="s">'Can not list files in </span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">.'</span> <span class="o">%</span>
+ <span class="p">(</span><span class="bp">self</span><span
class="o">.</span><span class="n">root_config_dir</span><span
class="p">,</span> <span class="n">dns_server</span><span
class="p">,</span> <span class="n">server_file</span><span
class="p">))</span>
+ <span class="k">for</span> <span class="n">view</span> <span
class="ow">in</span> <span class="n">named_files</span><span
class="p">:</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">__AddToTarFile__</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="n">server_file</span><span class="p">,</span> <span
class="n">view</span><span class="p">),</span>
+ <span class="s">'</span><span
class="si">%s</span><span class="s">/</span><span class="si">%s</span><span
class="s">'</span> <span class="o">%</span> <span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">),</span> <span
class="n">dns_tar_file</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">view</span> <span class="o">==</span> <span
class="s">'
named.ca'</span> <span class="p">):</span>
+ <span class="k">continue</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">view_files</span> <span class="o">=</span>
<span class="n">os</span><span class="o">.</span><span
class="n">listdir</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">/</span><span class="si">%s</span><span
class="s">'</span> <span class="o">%</span> <span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span>
+ <span class="n">dns_server</span><span
class="p">,</span> <span class="n">server_file</span><span
class="p">,</span> <span class="n">view</span><span class="p">))</span>
+ <span class="k">except</span> <span
class="ne">OSError</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ExporterListFileError</span><span class="p">(</span><span
class="s">'Invalid tree format, can not list '</span>
+ <span class="s">'files in </span><span
class="si">%s</span><span class="s">/</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">.'</span> <span class="o">%</span>
<span class="p">(</span><span class="bp">self</span><span
class="o">.</span><span class="n">root_config_dir</span><span
class="p">,</span> <span class="n">dns_server</span><span class="p">,</span>
+ <span
class="n">server_file</span><span class="p">,</span> <span
class="n">view</span><span class="p">))</span>
+ <span class="k">for</span> <span class="n">zone</span> <span
class="ow">in</span> <span class="n">view_files</span><span
class="p">:</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">__AddToTarFile__</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">'</span> <span class="o">%</span>
<span class="p">(</span><span class="n">server_file</span><span
class="p">,</span>
+ <span class="n">view</span><span class="p">,</span>
<span class="n">zone</span><span class="p">),</span> <span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">),</span>
+ <span class="n">dns_tar_file</span><span
class="p">)</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">__AddToTarFile__</span><span class="p">(</span><span
class="n">server_file</span><span class="p">,</span> <span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">),</span> <span
class="n">dns_tar_file</span><span class="p">)</span>
+ <span class="k">except</span> <span
class="n">ExporterFileError</span><span class="p">:</span>
+ <span class="n">dns_tar_file</span><span class="o">.</span><span
class="n">close</span><span class="p">()</span>
+ <span class="n">os</span><span class="o">.</span><span
class="n">remove</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">.tar.bz2'</span> <span
class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">,</span>
+ <span
class="n">dns_server</span><span class="p">))</span>
+ <span class="k">raise</span>
+ <span class="n">dns_tar_file</span><span class="o">.</span><span
class="n">close</span><span class="p">()</span>
+
+ <span class="c"># There are 2 ways to get zones. By reading the zone
files, or by named.conf</span>
+ <span class="c"># This uses the first. Opens more files, but has less
room for mistakes</span>
+ <span class="c"># because there is less parsing that is
done.</span></div>
+<div class="viewcode-block" id="ConfigLib.GetZoneList"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.GetZoneList">[docs]</a>
<span class="k">def</span> <span class="nf">GetZoneList</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">dns_server</span><span class="p">):</span>
+ <span class="sd">"""Gets all of the zones from a BIND
tree for a DNS server.</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> dns_server: name of a DNS server</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> dict: {'view1': {'zone1.lcl':
'zone.db', 'zone2'.lcl: 'zone.db'},</span>
+<span class="sd"> 'view2': {'zone3.lcl':
'zone.db', 'zone4.lcl': 'zone.db'}}</span>
+<span class="sd"> """</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">views</span> <span class="o">=</span> <span
class="n">os</span><span class="o">.</span><span
class="n">listdir</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span
class="s">/named/'</span> <span class="o">%</span> <span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">))</span>
+ <span class="n">zone_dict</span> <span class="o">=</span> <span
class="p">{}</span>
+ <span class="k">for</span> <span class="n">view</span> <span
class="ow">in</span> <span class="n">views</span><span class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">view</span> <span class="o">==</span> <span
class="s">'
named.ca'</span> <span class="p">):</span>
+ <span class="k">continue</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">view</span> <span class="ow">not</span> <span
class="ow">in</span> <span class="n">zone_dict</span> <span
class="p">):</span>
+ <span class="n">zone_dict</span><span class="p">[</span><span
class="n">view</span><span class="p">]</span> <span class="o">=</span>
<span class="p">{}</span>
+ <span class="n">zone_files</span> <span class="o">=</span> <span
class="n">os</span><span class="o">.</span><span
class="n">listdir</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span
class="s">/named/</span><span class="si">%s</span><span
class="s">'</span> <span class="o">%</span> <span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span>
+ <span
class="n">dns_server</span><span class="p">,</span> <span
class="n">view</span><span class="p">))</span>
+ <span class="k">for</span> <span class="n">zone_file_name</span>
<span class="ow">in</span> <span class="n">zone_files</span><span
class="p">:</span>
+ <span class="n">zone_file</span> <span class="o">=</span> <span
class="nb">open</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span
class="s">/named/</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span>
+ <span class="n">dns_server</span><span class="p">,</span>
<span class="n">view</span><span class="p">,</span> <span
class="n">zone_file_name</span><span class="p">))</span>
+ <span class="n">zone_origin</span> <span class="o">=</span>
<span class="s">''</span>
+ <span class="k">for</span> <span class="n">line</span> <span
class="ow">in</span> <span class="n">zone_file</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'ORIGIN'</span> <span class="ow">in</span> <span
class="n">line</span> <span class="p">):</span>
+ <span class="n">zone_origin</span> <span class="o">=</span>
<span class="n">line</span><span class="o">.</span><span
class="n">lstrip</span><span class="p">(</span><span class="s">'$ORIGIN
'</span><span class="p">)</span><span class="o">.</span><span
class="n">rstrip</span><span class="p">(</span><span
class="s">'.</span><span class="se">\n</span><span
class="s">'</span><span class="p">)</span>
+ <span class="k">break</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">zone_file</span><span class="o">.</span><span
class="n">close</span><span class="p">()</span>
+ <span class="k">raise</span> <span
class="n">errors</span><span class="o">.</span><span
class="n">FunctionError</span><span class="p">(</span><span
class="s">'Invalid zone file format for </span><span
class="si">%s</span><span class="s">.'</span> <span class="o">%</span>
+ <span
class="n">zone_file_name</span><span class="p">)</span>
+ <span class="n">zone_file</span><span class="o">.</span><span
class="n">close</span><span class="p">()</span>
+ <span class="n">zone_dict</span><span class="p">[</span><span
class="n">view</span><span class="p">][</span><span
class="n">zone_origin</span><span class="p">]</span> <span
class="o">=</span> <span class="n">zone_file_name</span>
+ <span class="k">except</span> <span class="ne">OSError</span> <span
class="k">as</span> <span class="n">err</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ServerCheckError</span><span class="p">(</span><span
class="s">'Can not list files in </span><span class="si">%s</span><span
class="s">.'</span> <span class="o">%</span> <span
class="n">err</span><span class="o">.</span><span
class="n">filename</span><span class="p">)</span>
+ <span class="k">return</span> <span class="n">zone_dict</span>
+</div>
+<div class="viewcode-block" id="ConfigLib.MergeOptionsDicts"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.MergeOptionsDicts">[docs]</a>
<span class="k">def</span> <span class="nf">MergeOptionsDicts</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">global_options_dict</span><span class="p">,</span> <span
class="n">view_dict</span><span class="p">,</span> <span
class="n">zone_dict</span><span class="p">):</span>
+ <span class="sd">"""Merges the options of 3
dictionaries, according to precendence.</span>
+<span class="sd"> zone_dict is the most importantce, while
global_options_dict has the "least"</span>
+<span class="sd"> importantance.</span>
+<span class="sd"> </span>
+<span class="sd"> Inputs:</span>
+<span class="sd"> global_options_dict: dict of the options defined
globally in named.conf</span>
+<span class="sd"> view_dict: dict of the options defined in a
single view of named.conf</span>
+<span class="sd"> zone_dict: dict of the options defined in a
single zone of named.conf</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> single_options_dict: dict of the merged
options</span>
+<span class="sd"> """</span>
+
+ <span class="n">single_options_dict</span> <span class="o">=</span>
<span class="p">{}</span>
+
+ <span class="c">#Go in order of least important to most
important</span>
+ <span class="k">for</span> <span class="n">options_dict</span> <span
class="ow">in</span> <span class="p">[</span><span
class="n">global_options_dict</span><span class="p">,</span> <span
class="n">view_dict</span><span class="p">,</span> <span
class="n">zone_dict</span><span class="p">]:</span>
+ <span class="k">for</span> <span class="n">key</span> <span
class="ow">in</span> <span class="n">options_dict</span><span
class="o">.</span><span class="n">keys</span><span class="p">():</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">key</span> <span class="ow">in</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">BIND_OPTION_CLAUSES</span> <span class="p">):</span>
+ <span class="n">single_options_dict</span><span
class="p">[</span><span class="n">key</span><span class="p">]</span> <span
class="o">=</span> <span class="n">options_dict</span><span
class="p">[</span><span class="n">key</span><span class="p">]</span>
+
+ <span class="c">#If we didn't fill in any of the options, we want
to fill in their defaults</span>
+ <span class="k">for</span> <span class="n">key</span> <span
class="ow">in</span> <span class="bp">self</span><span
class="o">.</span><span class="n">BIND_OPTION_CLAUSES</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">key</span> <span class="ow">not</span> <span class="ow">in</span>
<span class="n">single_options_dict</span><span class="o">.</span><span
class="n">keys</span><span class="p">()</span> <span class="p">):</span>
+ <span class="n">single_options_dict</span><span
class="p">[</span><span class="n">key</span><span class="p">]</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">BIND_OPTION_CLAUSES</span><span
class="p">[</span><span class="n">key</span><span class="p">]</span>
+
+ <span class="k">return</span> <span
class="n">single_options_dict</span>
+</div>
+<div class="viewcode-block"
id="ConfigLib.GenerateAdditionalNamedCheckzoneArgs"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.GenerateAdditionalNamedCheckzoneArgs">[docs]</a>
<span class="k">def</span> <span
class="nf">GenerateAdditionalNamedCheckzoneArgs</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">bind_options_dict</span><span class="p">):</span>
+ <span class="sd">"""Generates additional
named-checkzone command line flags and arguments based</span>
+<span class="sd"> on the BIND options supplied in
bind_options_dict.</span>
+<span class="sd"> </span>
+<span class="sd"> Inputs:</span>
+<span class="sd"> bind_options_dict: dict of BIND options parsed from
named.conf</span>
+<span class="sd"> </span>
+<span class="sd"> Outputs:</span>
+<span class="sd"> args: list of flags and their args.</span>
+<span class="sd"> """</span>
+
+ <span class="n">args</span> <span class="o">=</span> <span
class="p">[]</span>
+ <span class="n">check_siblings</span> <span class="o">=</span> <span
class="bp">False</span>
+
+ <span class="k">for</span> <span class="n">option_key</span><span
class="p">,</span> <span class="n">option_value</span> <span
class="ow">in</span> <span class="n">bind_options_dict</span><span
class="o">.</span><span class="n">items</span><span class="p">():</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">option_key</span> <span class="o">!=</span> <span
class="s">'check-siblings'</span> <span class="p">):</span>
+ <span class="n">checkzone_arg</span> <span class="o">=</span>
<span class="bp">None</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">option_value</span> <span class="ow">in</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">COMMANDS_CONVERT_DICT</span><span class="p">[</span><span
class="n">option_key</span><span class="p">]</span> <span
class="p">):</span>
+ <span class="n">checkzone_arg</span> <span class="o">=</span>
<span class="bp">self</span><span class="o">.</span><span
class="n">COMMANDS_CONVERT_DICT</span><span class="p">[</span><span
class="n">option_key</span><span class="p">][</span><span
class="n">option_value</span><span class="p">]</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="c">#These checks are for global and view
options</span>
+ <span class="c">#In some clauses, fail, warn, and ignore are not
enough.</span>
+ <span class="c">#master/slave/response warn/fail/ignore is the
correct syntax.</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'fail'</span> <span class="ow">in</span> <span
class="n">option_value</span> <span class="p">):</span>
+ <span class="n">checkzone_arg</span> <span class="o">=</span>
<span class="s">'fail'</span>
+ <span class="k">elif</span><span class="p">(</span> <span
class="s">'warn'</span> <span class="ow">in</span> <span
class="n">option_value</span> <span class="p">):</span>
+ <span class="n">checkzone_arg</span> <span class="o">=</span>
<span class="s">'warn'</span>
+ <span class="k">elif</span><span class="p">(</span> <span
class="s">'ignore'</span> <span class="ow">in</span> <span
class="n">option_value</span> <span class="p">):</span>
+ <span class="n">checkzone_arg</span> <span class="o">=</span>
<span class="s">'ignore'</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">print</span> <span class="s">'ERROR:
Unknown option "</span><span class="si">%s</span><span class="s">
</span><span class="si">%s</span><span class="s">"'</span> <span
class="o">%</span> <span class="p">(</span><span
class="n">option_key</span><span class="p">,</span> <span
class="n">option_value</span><span class="p">)</span>
+ <span class="n">sys</span><span class="o">.</span><span
class="n">exit</span><span class="p">(</span><span class="mi">1</span><span
class="p">)</span>
+
+ <span class="bp">self</span><span class="o">.</span><span
class="n">CHECKZONE_ARGS_DICT</span><span class="p">[</span><span
class="n">option_key</span><span class="p">][</span><span
class="s">'arg'</span><span class="p">]</span> <span
class="o">=</span> <span class="n">checkzone_arg</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">option_value</span> <span class="o">==</span> <span
class="s">'yes'</span> <span class="p">):</span>
+ <span class="n">check_siblings</span> <span class="o">=</span>
<span class="bp">True</span>
+
+ <span class="c">#if we want to check siblings, and if we are checking
integrity,</span>
+ <span class="c">#append '-sibling' to the -i arg of the
CHECKZONE_ARGS_DICT</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">check_siblings</span> <span class="ow">and</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">CHECKZONE_ARGS_DICT</span><span class="p">[</span><span
class="s">'check-integrity'</span><span class="p">][</span><span
class="s">'arg'</span><span class="p">]</span> <span
class="o">!=</span> <span class="s">'none'</span> <span
class="p">):</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">CHECKZONE_ARGS_DICT</span><span class="p">[</span><span
class="s">'check-integrity'</span><span class="p">][</span><span
class="s">'arg'</span><span class="p">]</span> <span
class="o">=</span> <span class="s">'</span><span
class="si">%s</span><span class="s">-sibling'</span> <span
class="o">%</span> <span class="p">(</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">CHECKZONE_ARGS_DICT</span><span class="p">[</span><span
class="s">'check-integrity'</span><span class="p">][</span><span
class="s">'arg'</span><span class="p">])</span>
+
+ <span class="c">#Transferring everything from CHECKZONE_ARGS_DICT to
args list</span>
+ <span class="k">for</span> <span class="n">key</span> <span
class="ow">in</span> <span class="bp">self</span><span
class="o">.</span><span class="n">CHECKZONE_ARGS_DICT</span><span
class="p">:</span>
+ <span class="n">flag</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">CHECKZONE_ARGS_DICT</span><span class="p">[</span><span
class="n">key</span><span class="p">][</span><span
class="s">'flag'</span><span class="p">]</span>
+ <span class="n">arg</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">CHECKZONE_ARGS_DICT</span><span class="p">[</span><span
class="n">key</span><span class="p">][</span><span
class="s">'arg'</span><span class="p">]</span>
+
+ <span class="n">args</span><span class="o">.</span><span
class="n">extend</span><span class="p">([</span><span
class="n">flag</span><span class="p">,</span> <span
class="n">arg</span><span class="p">])</span>
+
+ <span class="k">return</span> <span class="n">args</span>
+</div>
+<div class="viewcode-block" id="ConfigLib.GetNamedZoneToolArgs"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.GetNamedZoneToolArgs">[docs]</a>
<span class="k">def</span> <span
class="nf">GetNamedZoneToolArgs</span><span class="p">(</span><span
class="bp">self</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">,</span> <span
class="n">view</span><span class="p">,</span> <span
class="n">zone_file_name</span><span class="p">):</span>
+ <span class="sd">"""Generates the arg flags for
named-checkzone and named-compilezone</span>
+<span class="sd"> for a specific zone-view-server combination.</span>
+<span class="sd"> </span>
+<span class="sd"> Inputs:</span>
+<span class="sd"> dns_server: name of a DNS server</span>
+<span class="sd"> view: name of a view</span>
+<span class="sd"> zone_file_name: the file name of a zone</span>
+<span class="sd"> </span>
+<span class="sd"> Outputs:</span>
+<span class="sd"> string: string of the command flags and their
values for named-checkzone</span>
+<span class="sd"> and named-compilezone.</span>
+<span class="sd"> """</span>
+ <span class="n">zone_name</span> <span class="o">=</span> <span
class="n">zone_file_name</span><span class="o">.</span><span
class="n">rstrip</span><span class="p">(</span><span
class="s">'.db'</span><span class="p">)</span>
+ <span class="n">server_directory</span> <span class="o">=</span> <span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">)</span>
+ <span class="n">named_file_name</span> <span class="o">=</span> <span
class="s">'</span><span class="si">%s</span><span
class="s">/named.conf.a'</span> <span class="o">%</span> <span
class="n">server_directory</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">named_file_handle</span> <span class="o">=</span>
<span class="nb">open</span><span class="p">(</span><span
class="n">named_file_name</span><span class="p">,</span> <span
class="s">'r'</span><span class="p">)</span>
+ <span class="n">named_file_string</span> <span class="o">=</span>
<span class="n">named_file_handle</span><span class="o">.</span><span
class="n">read</span><span class="p">()</span>
+ <span class="k">finally</span><span class="p">:</span>
+ <span class="n">named_file_handle</span><span
class="o">.</span><span class="n">close</span><span class="p">()</span>
+
+ <span class="n">named_file_dict</span> <span class="o">=</span> <span
class="n">iscpy</span><span class="o">.</span><span
class="n">ParseISCString</span><span class="p">(</span><span
class="n">named_file_string</span><span class="p">)</span>
+ <span class="n">global_options_dict</span> <span class="o">=</span>
<span class="n">named_file_dict</span><span class="p">[</span><span
class="s">'options'</span><span class="p">]</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'view "</span><span class="si">%s</span><span
class="s">"'</span> <span class="o">%</span> <span
class="n">view</span> <span class="ow">not</span> <span
class="ow">in</span> <span class="n">named_file_dict</span> <span
class="p">):</span>
+ <span class="k">raise</span> <span
class="n">ConfigManagerError</span><span class="p">(</span><span
class="s">'Could not find view </span><span class="si">%s</span><span
class="s"> in named.conf'</span> <span class="o">%</span> <span
class="n">view</span><span class="p">)</span>
+ <span class="n">view_dict</span> <span class="o">=</span> <span
class="n">named_file_dict</span><span class="p">[</span><span
class="s">'view "</span><span class="si">%s</span><span
class="s">"'</span> <span class="o">%</span> <span
class="n">view</span><span class="p">]</span>
+
+ <span class="n">zone_dict</span> <span class="o">=</span> <span
class="bp">None</span>
+ <span class="k">for</span> <span class="n">zone</span> <span
class="ow">in</span> <span class="n">view_dict</span><span
class="p">:</span>
+ <span class="c">#Making sure we're checking a dictionary</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="nb">type</span><span class="p">(</span><span
class="n">view_dict</span><span class="p">[</span><span
class="n">zone</span><span class="p">])</span> <span class="o">==</span>
<span class="nb">type</span><span class="p">({})</span> <span
class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'file'</span> <span class="ow">in</span> <span
class="n">view_dict</span><span class="p">[</span><span
class="n">zone</span><span class="p">]</span><span class="o">.</span><span
class="n">keys</span><span class="p">()</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">view_dict</span><span class="p">[</span><span
class="n">zone</span><span class="p">][</span><span
class="s">'file'</span><span class="p">]</span><span
class="o">.</span><span class="n">strip</span><span class="p">(</span><span
class="s">'"'</span><span class="p">)</span><span
class="o">.</span><span class="n">endswith</span><span
class="p">(</span><span class="n">zone_file_name</span><span
class="p">)</span> <span class="p">):</span>
+ <span class="n">zone_dict</span> <span class="o">=</span>
<span class="n">view_dict</span><span class="p">[</span><span
class="n">zone</span><span class="p">]</span>
+ <span class="k">break</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ConfigManagerError</span><span class="p">(</span><span
class="s">'Could not find zone </span><span class="si">%s</span><span
class="s"> in view </span><span class="si">%s</span><span class="s"> within
named.conf'</span> <span class="o">%</span> <span
class="p">(</span><span class="n">zone_name</span><span class="p">,</span>
<span class="n">view</span><span class="p">))</span>
+
+ <span class="n">options_dict</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">MergeOptionsDicts</span><span class="p">(</span>
+ <span class="n">global_options_dict</span><span class="p">,</span>
<span class="n">view_dict</span><span class="p">,</span> <span
class="n">zone_dict</span><span class="p">)</span>
+ <span class="n">additional_args</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">GenerateAdditionalNamedCheckzoneArgs</span><span
class="p">(</span><span class="n">options_dict</span><span
class="p">)</span>
+
+ <span class="k">return</span> <span class="s">' '</span><span
class="o">.</span><span class="n">join</span><span class="p">(</span><span
class="n">additional_args</span><span class="p">)</span></div></div>
+</pre></div>
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="../../search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../../genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ <li><a href="../index.html" >Module code</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2013, Purdue University.
+ Created using <a href="
http://sphinx-doc.org/">Sphinx</a> 1.2b1.
+ </div>
+ </body>
+</html>
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager/db_recovery.html
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,248 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="
http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>roster_config_manager.db_recovery — Roster Config Manager
v0.18 documentation</title>
+
+ <link rel="stylesheet" href="../../_static/default.css"
type="text/css" />
+ <link rel="stylesheet" href="../../_static/pygments.css"
type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: '../../',
+ VERSION: 'v0.18',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="../../_static/jquery.js"></script>
+ <script type="text/javascript"
src="../../_static/underscore.js"></script>
+ <script type="text/javascript"
src="../../_static/doctools.js"></script>
+ <link rel="top" title="Roster Config Manager v0.18 documentation"
href="../../index.html" />
+ <link rel="up" title="Module code" href="../index.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../../genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ <li><a href="../index.html" accesskey="U">Module code</a>
»</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <h1>Source code for roster_config_manager.db_recovery</h1><div
class="highlight"><pre>
+<span class="c">#!/usr/bin/python</span>
+
+<span class="c"># Copyright (c) 2009, Purdue University</span>
+<span class="c"># All rights reserved.</span>
+<span class="c">#</span>
+<span class="c"># Redistribution and use in source and binary forms, with
or without</span>
+<span class="c"># modification, are permitted provided that the following
conditions are met:</span>
+<span class="c">#</span>
+<span class="c"># Redistributions of source code must retain the above
copyright notice, this</span>
+<span class="c"># list of conditions and the following disclaimer.</span>
+<span class="c">#</span>
+<span class="c"># Redistributions in binary form must reproduce the above
copyright notice, this</span>
+<span class="c"># list of conditions and the following disclaimer in the
documentation and/or</span>
+<span class="c"># other materials provided with the distribution.</span>
+<span class="c">#</span>
+<span class="c"># Neither the name of the Purdue University nor the names
of its contributors</span>
+<span class="c"># may be used to endorse or promote products derived from
this software without</span>
+<span class="c"># specific prior written permission.</span>
+<span class="c">#</span>
+<span class="c"># THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS"</span>
+<span class="c"># AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
NOT LIMITED TO, THE</span>
+<span class="c"># IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE</span>
+<span class="c"># DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
CONTRIBUTORS BE LIABLE</span>
+<span class="c"># FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL</span>
+<span class="c"># DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR</span>
+<span class="c"># SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER</span>
+<span class="c"># CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY,</span>
+<span class="c"># OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE</span>
+<span class="c"># OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.</span>
+
+<span class="sd">"""This module contains all of the logic
for the recovery system.</span>
+
+<span class="sd">It should be only called by the roster recovery
system.</span>
+<span class="sd">"""</span>
+
+<span class="n">__copyright__</span> <span class="o">=</span> <span
class="s">'Copyright (C) 2009, Purdue University'</span>
+<span class="n">__license__</span> <span class="o">=</span> <span
class="s">'BSD'</span>
+<span class="n">__version__</span> <span class="o">=</span> <span
class="s">'#TRUNK#'</span>
+
+<span class="kn">import</span> <span class="nn">roster_core</span>
+<span class="kn">import</span> <span class="nn">os</span>
+<span class="kn">import</span> <span class="nn">bz2</span>
+<span class="kn">import</span> <span class="nn">cPickle</span>
+
+
+<span class="n">roster_core</span><span class="o">.</span><span
class="n">core</span><span class="o">.</span><span
class="n">CheckCoreVersionMatches</span><span class="p">(</span><span
class="n">__version__</span><span class="p">)</span>
+
+<span class="c">#Used in dnsrecover</span>
+<span class="n">WARNING_STRING</span> <span class="o">=</span> <span
class="p">(</span>
+ <span class="s">'After running dnsrecover, running dnstreexport is
recommended. '</span>
+ <span class="s">'If dnstreeexport is not run, running dnsrecover
again will cause '</span>
+ <span class="s">'duplicate errors.'</span><span
class="p">)</span>
+
+<div class="viewcode-block" id="Recover"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.db_recovery.Recover">[docs]</a><span
class="k">class</span> <span class="nc">Recover</span><span
class="p">(</span><span class="nb">object</span><span class="p">):</span>
+ <span class="sd">"""Roster Recovery</span>
+
+<span class="sd"> This class contains methods pertaining to recover
roster after</span>
+<span class="sd"> catastrophic failure.</span>
+<span class="sd"> """</span>
+ <span class="k">def</span> <span class="nf">__init__</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">username</span><span class="p">,</span> <span
class="n">config_instance</span><span class="p">):</span>
+ <span class="sd">"""Sets self.db_instance</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> config_instance: instantiated config class
object</span>
+<span class="sd"> """</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">username</span> <span class="o">=</span> <span
class="n">username</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">config_instance</span> <span class="o">=</span> <span
class="n">config_instance</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span> <span class="o">=</span> <span
class="n">config_instance</span><span class="o">.</span><span
class="n">GetDb</span><span class="p">()</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">core_instance</span> <span class="o">=</span> <span
class="n">roster_core</span><span class="o">.</span><span
class="n">Core</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">username</span><span class="p">,</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">config_instance</span><span class="p">)</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">core_helper_instance</span> <span class="o">=</span> <span
class="n">roster_core</span><span class="o">.</span><span
class="n">CoreHelpers</span><span class="p">(</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">core_instance</span><span class="p">)</span>
+
+<div class="viewcode-block" id="Recover.PushBackup"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.db_recovery.Recover.PushBackup">[docs]</a>
<span class="k">def</span> <span class="nf">PushBackup</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">audit_log_id</span><span class="p">):</span>
+ <span class="sd">"""Restores database from sql backup
with specified audit log id</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> audit_log_id: integer of audit log id</span>
+<span class="sd"> """</span>
+ <span class="n">backup_dir</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">config_instance</span><span class="o">.</span><span
class="n">config_file</span><span class="p">[</span><span
class="s">'exporter'</span><span class="p">][</span><span
class="s">'backup_dir'</span><span class="p">]</span>
+
+ <span class="n">full_dump_file</span> <span class="o">=</span> <span
class="n">bz2</span><span class="o">.</span><span
class="n">BZ2File</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/audit_log_replay_dump-</span><span class="si">%s</span><span
class="s">.bz2'</span> <span class="o">%</span>
+ <span class="p">(</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">audit_log_id</span><span class="p">))</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">full_dump_file_contents</span> <span
class="o">=</span> <span class="n">full_dump_file</span><span
class="o">.</span><span class="n">read</span><span class="p">()</span>
+ <span class="k">finally</span><span class="p">:</span>
+ <span class="n">full_dump_file</span><span class="o">.</span><span
class="n">close</span><span class="p">()</span>
+
+ <span class="k">print</span> <span class="s">'Loading database
from backup with ID </span><span class="si">%s</span><span
class="s">'</span> <span class="o">%</span> <span
class="n">audit_log_id</span>
+
+ <span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">StartTransaction</span><span class="p">()</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">cursor</span><span class="o">.</span><span
class="n">execute</span><span class="p">(</span><span
class="n">full_dump_file_contents</span><span class="p">)</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">EndTransaction</span><span class="p">()</span>
+</div>
+<div class="viewcode-block" id="Recover.RunAuditStep"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.db_recovery.Recover.RunAuditStep">[docs]</a>
<span class="k">def</span> <span class="nf">RunAuditStep</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">audit_log_id</span><span class="p">):</span>
+ <span class="sd">"""Runs a step from the
audit_log</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> audit_log_id: integer of audit_log_id</span>
+
+<span class="sd"> Raises:</span>
+<span class="sd"> RecoverError: Should a error occur in
recovery.</span>
+<span class="sd"> """</span>
+ <span class="n">forbidden_actions</span> <span class="o">=</span>
<span class="p">[</span><span
class="s">'ExportAllBindTrees'</span><span class="p">]</span>
+ <span class="n">audit_dict</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">GetEmptyRowDict</span><span class="p">(</span><span
class="s">'audit_log'</span><span class="p">)</span>
+ <span class="n">audit_dict</span><span class="p">[</span><span
class="s">'audit_log_id'</span><span class="p">]</span> <span
class="o">=</span> <span class="n">audit_log_id</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">StartTransaction</span><span class="p">()</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">audit_log</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">ListRow</span><span class="p">(</span><span
class="s">'audit_log'</span><span class="p">,</span> <span
class="n">audit_dict</span><span class="p">)</span>
+ <span class="k">finally</span><span class="p">:</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">EndTransaction</span><span class="p">()</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">audit_log</span> <span class="o">==</span> <span
class="p">()</span> <span class="p">):</span>
+ <span class="k">print</span> <span class="s">'Not replaying
action with id </span><span class="si">%s</span><span class="s">, action is
blank.'</span> <span class="o">%</span> <span
class="n">audit_log_id</span>
+ <span class="k">return</span> <span class="bp">False</span>
+ <span class="n">action</span> <span class="o">=</span> <span
class="n">audit_log</span><span class="p">[</span><span
class="mi">0</span><span class="p">][</span><span
class="s">'action'</span><span class="p">]</span>
+ <span class="n">success</span> <span class="o">=</span> <span
class="n">audit_log</span><span class="p">[</span><span
class="mi">0</span><span class="p">][</span><span
class="s">'success'</span><span class="p">]</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">action</span> <span class="ow">in</span> <span
class="n">forbidden_actions</span> <span class="p">):</span>
+ <span class="k">print</span> <span class="s">'Not replaying
action with id </span><span class="si">%s</span><span class="s">, action
not allowed.'</span> <span class="o">%</span> <span
class="n">audit_log_id</span>
+ <span class="k">elif</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">success</span> <span
class="p">):</span>
+ <span class="k">print</span> <span class="s">'Not replaying
action with id </span><span class="si">%s</span><span class="s">, action
was unsuccessful.'</span> <span class="o">%</span> <span
class="n">audit_log_id</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">data</span> <span class="o">=</span> <span
class="n">cPickle</span><span class="o">.</span><span
class="n">loads</span><span class="p">(</span><span
class="nb">str</span><span class="p">(</span><span
class="n">audit_log</span><span class="p">[</span><span
class="mi">0</span><span class="p">][</span><span
class="s">'data'</span><span class="p">]))[</span><span
class="s">'replay_args'</span><span class="p">]</span>
+ <span class="k">print</span> <span class="s">'Replaying action
with id </span><span class="si">%s</span><span class="s">: </span><span
class="si">%s</span><span class="se">\n</span><span class="s">with
arguments: </span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span>
+ <span class="n">audit_log_id</span><span class="p">,</span>
<span class="n">action</span><span class="p">,</span> <span
class="nb">str</span><span class="p">(</span><span
class="n">data</span><span class="p">))</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="nb">hasattr</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">core_instance</span><span class="p">,</span> <span
class="n">action</span><span class="p">)</span> <span class="p">):</span>
+ <span class="n">function</span> <span class="o">=</span> <span
class="nb">getattr</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">core_instance</span><span class="p">,</span> <span
class="n">action</span><span class="p">)</span>
+ <span class="n">function</span><span class="p">(</span><span
class="o">*</span><span class="n">data</span><span class="p">)</span>
+ <span class="k">elif</span><span class="p">(</span> <span
class="nb">hasattr</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">core_helper_instance</span><span class="p">,</span> <span
class="n">action</span><span class="p">)</span> <span class="p">):</span>
+ <span class="n">function</span> <span class="o">=</span> <span
class="nb">getattr</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">core_helper_instance</span><span class="p">,</span> <span
class="n">action</span><span class="p">)</span>
+ <span class="n">function</span><span class="p">(</span><span
class="o">*</span><span class="n">data</span><span class="p">)</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">roster_core</span><span class="o">.</span><span
class="n">errors</span><span class="o">.</span><span
class="n">UnexpectedDataError</span><span class="p">(</span>
+ <span class="s">"Function </span><span
class="si">%s</span><span class="s"> does not exist."</span> <span
class="o">%</span> <span class="n">action</span><span class="p">)</span>
+ <span class="k">return</span> <span class="bp">True</span>
+</div>
+<div class="viewcode-block" id="Recover.RunAuditRange"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.db_recovery.Recover.RunAuditRange">[docs]</a>
<span class="k">def</span> <span class="nf">RunAuditRange</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">audit_log_id</span><span class="p">):</span>
+ <span class="sd">"""Runs a range of audit steps</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> audit_log_id: integer of audit_log_id</span>
+<span class="sd"> """</span>
+ <span class="n">backup_dir</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">config_instance</span><span class="o">.</span><span
class="n">config_file</span><span class="p">[</span><span
class="s">'exporter'</span><span class="p">][</span><span
class="s">'backup_dir'</span><span class="p">]</span>
+ <span class="n">file_list</span> <span class="o">=</span> <span
class="n">os</span><span class="o">.</span><span
class="n">listdir</span><span class="p">(</span><span
class="n">backup_dir</span><span class="p">)</span>
+ <span class="n">db_dumps</span> <span class="o">=</span> <span
class="p">[]</span>
+
+ <span class="k">for</span> <span class="n">fname</span> <span
class="ow">in</span> <span class="n">file_list</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">fname</span><span class="o">.</span><span
class="n">startswith</span><span class="p">(</span><span
class="s">'audit_log_replay_dump-'</span><span class="p">)</span>
<span class="p">):</span>
+ <span class="n">db_dumps</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="nb">int</span><span class="p">(</span><span
class="n">fname</span><span class="o">.</span><span
class="n">split</span><span class="p">(</span><span
class="s">'-'</span><span class="p">)[</span><span
class="mi">1</span><span class="p">]</span><span class="o">.</span><span
class="n">split</span><span class="p">(</span><span
class="s">'.'</span><span class="p">)[</span><span
class="mi">0</span><span class="p">]))</span>
+ <span class="n">audit_id</span> <span class="o">=</span> <span
class="mi">0</span>
+ <span class="k">for</span> <span class="n">audit_id</span> <span
class="ow">in</span> <span class="nb">reversed</span><span
class="p">(</span><span class="nb">sorted</span><span
class="p">(</span><span class="n">db_dumps</span><span class="p">)):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">audit_id</span> <span class="o"><</span> <span
class="n">audit_log_id</span> <span class="p">):</span>
+ <span class="k">break</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">PushBackup</span><span class="p">(</span><span
class="n">audit_id</span><span class="p">)</span>
+
+ <span class="k">for</span> <span class="n">current_id</span> <span
class="ow">in</span> <span class="nb">range</span><span
class="p">(</span><span class="n">audit_id</span> <span class="o">+</span>
<span class="mi">1</span><span class="p">,</span> <span
class="n">audit_log_id</span><span class="p">):</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">RunAuditStep</span><span class="p">(</span><span
class="n">current_id</span><span class="p">)</span>
+ <span class="k">return</span> <span class="bp">True</span></div></div>
+</pre></div>
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="../../search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../../genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ <li><a href="../index.html" >Module code</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2013, Purdue University.
+ Created using <a href="
http://sphinx-doc.org/">Sphinx</a> 1.2b1.
+ </div>
+ </body>
+</html>
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager/dns_query_lib.html
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,369 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="
http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>roster_config_manager.dns_query_lib — Roster Config
Manager v0.18 documentation</title>
+
+ <link rel="stylesheet" href="../../_static/default.css"
type="text/css" />
+ <link rel="stylesheet" href="../../_static/pygments.css"
type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: '../../',
+ VERSION: 'v0.18',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="../../_static/jquery.js"></script>
+ <script type="text/javascript"
src="../../_static/underscore.js"></script>
+ <script type="text/javascript"
src="../../_static/doctools.js"></script>
+ <link rel="top" title="Roster Config Manager v0.18 documentation"
href="../../index.html" />
+ <link rel="up" title="Module code" href="../index.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../../genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ <li><a href="../index.html" accesskey="U">Module code</a>
»</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <h1>Source code for roster_config_manager.dns_query_lib</h1><div
class="highlight"><pre>
+<span class="c">#! /usr/bin/env python</span>
+<span class="c">#</span>
+<span class="c"># Copyright (c) 2009, Purdue University</span>
+<span class="c"># All rights reserved.</span>
+<span class="c">#</span>
+<span class="c"># Redistribution and use in source and binary forms, with
or without</span>
+<span class="c"># modification, are permitted provided that the following
conditions are met:</span>
+<span class="c">#</span>
+<span class="c"># Redistributions of source code must retain the above
copyright notice, this</span>
+<span class="c"># list of conditions and the following disclaimer.</span>
+<span class="c">#</span>
+<span class="c"># Redistributions in binary form must reproduce the above
copyright notice, this</span>
+<span class="c"># list of conditions and the following disclaimer in the
documentation and/or</span>
+<span class="c"># other materials provided with the distribution.</span>
+<span class="c">#</span>
+<span class="c"># Neither the name of the Purdue University nor the names
of its contributors</span>
+<span class="c"># may be used to endorse or promote products derived from
this software without</span>
+<span class="c"># specific prior written permission.</span>
+<span class="c">#</span>
+<span class="c"># THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS"</span>
+<span class="c"># AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
NOT LIMITED TO, THE</span>
+<span class="c"># IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE</span>
+<span class="c"># DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
CONTRIBUTORS BE LIABLE</span>
+<span class="c"># FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL</span>
+<span class="c"># DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR</span>
+<span class="c"># SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER</span>
+<span class="c"># CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY,</span>
+<span class="c"># OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE</span>
+<span class="c"># OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.</span>
+
+<span class="sd">"""This module contains all the logic for
querying a DNS server.</span>
+<span class="sd">It is used by dnsquerycheck."""</span>
+
+<span class="n">__copyright__</span> <span class="o">=</span> <span
class="s">'Copyright (C) 2009, Purdue University'</span>
+<span class="n">__license__</span> <span class="o">=</span> <span
class="s">'BSD'</span>
+<span class="n">__version__</span> <span class="o">=</span> <span
class="s">'#TRUNK#'</span>
+
+<span class="kn">import</span> <span class="nn">random</span>
+<span class="kn">import</span> <span class="nn">socket</span>
+<span class="kn">import</span> <span class="nn">dns.zone</span>
+<span class="kn">import</span> <span class="nn">dns.query</span>
+
+<span class="kn">import</span> <span class="nn">roster_core</span>
+<span class="kn">from</span> <span class="nn">roster_config_manager</span>
<span class="kn">import</span> <span class="n">config_lib</span>
+<span class="kn">from</span> <span class="nn">roster_core</span> <span
class="kn">import</span> <span class="n">errors</span>
+<span class="kn">from</span> <span class="nn">roster_core</span> <span
class="kn">import</span> <span class="n">helpers_lib</span>
+
+<span class="n">roster_core</span><span class="o">.</span><span
class="n">core</span><span class="o">.</span><span
class="n">CheckCoreVersionMatches</span><span class="p">(</span><span
class="n">__version__</span><span class="p">)</span>
+
+<div class="viewcode-block" id="DnsQuery"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.dns_query_lib.DnsQuery">[docs]</a><span
class="k">def</span> <span class="nf">DnsQuery</span><span
class="p">(</span><span class="n">records</span><span class="p">,</span>
<span class="n">dns_server</span><span class="p">,</span> <span
class="n">dns_port</span><span class="p">,</span> <span
class="n">zone_origin</span><span class="p">):</span>
+ <span class="sd">"""Queries a DNS server for all the
records contained within the</span>
+<span class="sd"> supplied list of records.</span>
+<span class="sd"> </span>
+<span class="sd"> Input:</span>
+<span class="sd"> records: list of record dictionaries.</span>
+<span class="sd"> dns_server: string of IP Address or hostname of DNS
server.</span>
+<span class="sd"> dns_port: int of port to query DNS server on.</span>
+<span class="sd"> zone_origin: string of zone origin.</span>
+<span class="sd"> </span>
+<span class="sd"> Output:</span>
+<span class="sd"> (good_records, bad_records): a tuple of 2
lists,</span>
+<span class="sd"> the first being all the records that were able to
</span>
+<span class="sd"> be verified, the second being all the records
unable</span>
+<span class="sd"> to be verified.</span>
+
+<span class="sd"> example: ([u'0.168.192.in-addr.arpa. 86400 IN
NS ns2.university.lcl.',</span>
+<span class="sd"> u'1.0.168.192.in-addr.arpa. 86400 IN
PTR router.university.lcl.',</span>
+<span class="sd"> u'11.0.168.192.in-addr.arpa. 86400
IN PTR desktop-1.university.lcl.',</span>
+<span class="sd"> u'12.0.168.192.in-addr.arpa. 86400
IN PTR desktop-2.university.lcl.'],</span>
+
+<span class="sd"> [u'13.0.168.192.in-addr.arpa. 86400
IN PTR desktop-3.university.lcl.'])</span>
+
+<span class="sd"> Raises:</span>
+<span class="sd"> errors.UnexpectedDataError: No zone origin
supplied.</span>
+<span class="sd"> errors.UnexpectedDataError: Invalid record
type.</span>
+<span class="sd"> errors.UnexpectedDataError: Invalid record
class."""</span>
+
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">dns_server</span> <span class="o">=</span> <span
class="n">socket</span><span class="o">.</span><span
class="n">gethostbyname</span><span class="p">(</span><span
class="n">dns_server</span><span class="p">)</span>
+ <span class="k">except</span> <span class="n">socket</span><span
class="o">.</span><span class="n">gaierror</span><span class="p">:</span>
+ <span class="k">raise</span> <span class="n">config_lib</span><span
class="o">.</span><span class="n">ConfigManagerError</span><span
class="p">(</span><span class="s">'ERROR: Could not find address
'</span>
+ <span class="s">'associated with </span><span
class="si">%s</span><span class="s">.'</span> <span class="o">%</span>
<span class="n">dns_server</span><span class="p">)</span>
+
+ <span class="n">good_records</span> <span class="o">=</span> <span
class="p">[]</span>
+ <span class="n">record_types</span> <span class="o">=</span> <span
class="p">{</span>
+ <span class="s">u'a'</span><span class="p">:</span> <span
class="n">dns</span><span class="o">.</span><span
class="n">rdatatype</span><span class="o">.</span><span
class="n">A</span><span class="p">,</span>
+ <span class="s">u'aaaa'</span><span class="p">:</span> <span
class="n">dns</span><span class="o">.</span><span
class="n">rdatatype</span><span class="o">.</span><span
class="n">AAAA</span><span class="p">,</span>
+ <span class="s">u'cname'</span><span class="p">:</span> <span
class="n">dns</span><span class="o">.</span><span
class="n">rdatatype</span><span class="o">.</span><span
class="n">CNAME</span><span class="p">,</span>
+ <span class="s">u'soa'</span><span class="p">:</span> <span
class="n">dns</span><span class="o">.</span><span
class="n">rdatatype</span><span class="o">.</span><span
class="n">SOA</span><span class="p">,</span>
+ <span class="s">u'mx'</span><span class="p">:</span> <span
class="n">dns</span><span class="o">.</span><span
class="n">rdatatype</span><span class="o">.</span><span
class="n">MX</span><span class="p">,</span>
+ <span class="s">u'ns'</span><span class="p">:</span> <span
class="n">dns</span><span class="o">.</span><span
class="n">rdatatype</span><span class="o">.</span><span
class="n">NS</span><span class="p">,</span>
+ <span class="s">u'ptr'</span><span class="p">:</span> <span
class="n">dns</span><span class="o">.</span><span
class="n">rdatatype</span><span class="o">.</span><span
class="n">PTR</span><span class="p">,</span>
+ <span class="s">u'txt'</span><span class="p">:</span> <span
class="n">dns</span><span class="o">.</span><span
class="n">rdatatype</span><span class="o">.</span><span
class="n">TXT</span><span class="p">,</span>
+ <span class="s">u'hinfo'</span><span class="p">:</span> <span
class="n">dns</span><span class="o">.</span><span
class="n">rdatatype</span><span class="o">.</span><span
class="n">HINFO</span><span class="p">,</span>
+ <span class="s">u'srv'</span><span class="p">:</span> <span
class="n">dns</span><span class="o">.</span><span
class="n">rdatatype</span><span class="o">.</span><span class="n">SRV</span>
+ <span class="p">}</span>
+
+ <span class="c">#Main loop, going through the zone records, querying the
DNS server for them</span>
+ <span class="k">for</span> <span class="n">record</span> <span
class="ow">in</span> <span class="n">records</span><span class="p">:</span>
+ <span class="n">server_responses</span> <span class="o">=</span> <span
class="p">[]</span>
+ <span class="n">record_type</span> <span class="o">=</span> <span
class="n">record</span><span class="p">[</span><span
class="s">'record_type'</span><span class="p">]</span>
+ <span class="n">rdtype</span> <span class="o">=</span> <span
class="n">record_types</span><span class="p">[</span><span
class="n">record_type</span><span class="p">]</span>
+ <span class="n">record_arguments</span> <span class="o">=</span> <span
class="n">record</span><span class="p">[</span><span
class="s">'record_arguments'</span><span class="p">]</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'record_target'</span> <span class="ow">in</span> <span
class="n">record</span> <span class="p">):</span>
+ <span class="n">record_target</span> <span class="o">=</span> <span
class="n">record</span><span class="p">[</span><span
class="s">'record_target'</span><span class="p">]</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">record_target</span> <span class="o">=</span> <span
class="n">record</span><span class="p">[</span><span
class="s">'target'</span><span class="p">]</span>
+
+ <span class="c">#Setting query </span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record_target</span> <span class="o">==</span> <span
class="s">'@'</span> <span class="p">):</span>
+ <span class="n">query</span> <span class="o">=</span> <span
class="n">zone_origin</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">query</span> <span class="o">=</span> <span
class="s">'</span><span class="si">%s</span><span
class="s">.</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="n">record_target</span><span class="p">,</span> <span
class="n">zone_origin</span><span class="p">)</span>
+
+ <span class="n">message</span> <span class="o">=</span> <span
class="n">dns</span><span class="o">.</span><span
class="n">message</span><span class="o">.</span><span
class="n">make_query</span><span class="p">(</span><span
class="n">query</span><span class="p">,</span> <span
class="n">rdtype</span><span class="o">=</span><span
class="n">rdtype</span><span class="p">)</span>
+
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">response</span> <span class="o">=</span> <span
class="n">dns</span><span class="o">.</span><span
class="n">query</span><span class="o">.</span><span
class="n">udp</span><span class="p">(</span><span
class="n">message</span><span class="p">,</span> <span
class="n">dns_server</span><span class="p">,</span>
+ <span class="n">port</span><span class="o">=</span><span
class="nb">int</span><span class="p">(</span><span
class="n">dns_port</span><span class="p">),</span> <span
class="n">one_rr_per_rrset</span><span class="o">=</span><span
class="bp">False</span><span class="p">,</span> <span
class="n">timeout</span><span class="o">=</span><span
class="mi">10</span><span class="p">)</span>
+ <span class="k">except</span> <span class="n">dns</span><span
class="o">.</span><span class="n">exception</span><span
class="o">.</span><span class="n">Timeout</span><span class="p">:</span>
+ <span class="k">raise</span> <span class="n">config_lib</span><span
class="o">.</span><span class="n">QueryCheckError</span><span
class="p">(</span><span class="s">'Querying DNS server timed
out.'</span><span class="p">)</span>
+ <span class="k">except</span> <span class="n">dns</span><span
class="o">.</span><span class="n">exception</span><span
class="o">.</span><span class="n">SyntaxError</span><span class="p">:</span>
+ <span class="k">raise</span> <span class="n">config_lib</span><span
class="o">.</span><span class="n">QueryCheckError</span><span
class="p">(</span><span class="s">'Invalid DNS server
address.'</span><span class="p">)</span>
+ <span class="k">except</span> <span class="n">dns</span><span
class="o">.</span><span class="n">exception</span><span
class="o">.</span><span class="n">DNSException</span><span
class="p">:</span>
+ <span class="k">raise</span> <span class="n">config_lib</span><span
class="o">.</span><span class="n">QueryCheckError</span><span
class="p">(</span><span class="s">'Unknown error during DNS query
'</span>
+ <span
class="s">'process.'</span><span class="p">)</span>
+
+ <span class="n">answers</span> <span class="o">=</span> <span
class="n">response</span><span class="o">.</span><span
class="n">answer</span>
+
+ <span class="c">#checking that record type and target match</span>
+ <span class="k">for</span> <span class="n">answer</span> <span
class="ow">in</span> <span class="n">answers</span><span class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="nb">int</span><span class="p">(</span><span
class="n">answer</span><span class="o">.</span><span
class="n">rdtype</span><span class="p">)</span> <span class="o">==</span>
<span class="nb">int</span><span class="p">(</span><span
class="n">rdtype</span><span class="p">)</span> <span class="ow">and</span>
+ <span class="nb">unicode</span><span class="p">(</span><span
class="n">answer</span><span class="o">.</span><span
class="n">name</span><span class="p">)</span> <span class="o">==</span>
<span class="nb">unicode</span><span class="p">(</span><span
class="n">query</span><span class="p">)</span> <span class="p">):</span>
+ <span class="k">break</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">continue</span>
+
+ <span class="k">for</span> <span class="n">answer_set</span> <span
class="ow">in</span> <span class="n">answers</span><span class="p">:</span>
+ <span class="k">for</span> <span class="n">answer</span> <span
class="ow">in</span> <span class="n">answer_set</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record_type</span> <span class="o">==</span> <span
class="s">u'soa'</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record_arguments</span><span class="p">[</span><span
class="s">u'refresh_seconds'</span><span class="p">]</span> <span
class="o">==</span> <span class="n">answer</span><span
class="o">.</span><span class="n">refresh</span> <span class="ow">and</span>
+ <span class="n">record_arguments</span><span
class="p">[</span><span class="s">u'expiry_seconds'</span><span
class="p">]</span> <span class="o">==</span> <span
class="n">answer</span><span class="o">.</span><span
class="n">expire</span> <span class="ow">and</span>
+ <span class="n">record_arguments</span><span
class="p">[</span><span class="s">u'minimum_seconds'</span><span
class="p">]</span> <span class="o">==</span> <span
class="n">answer</span><span class="o">.</span><span
class="n">minimum</span> <span class="ow">and</span>
+ <span class="n">record_arguments</span><span
class="p">[</span><span class="s">u'retry_seconds'</span><span
class="p">]</span> <span class="o">==</span> <span
class="n">answer</span><span class="o">.</span><span
class="n">retry</span> <span class="ow">and</span>
+ <span class="n">record_arguments</span><span
class="p">[</span><span class="s">u'name_server'</span><span
class="p">]</span> <span class="o">==</span> <span
class="nb">unicode</span><span class="p">(</span><span
class="n">answer</span><span class="o">.</span><span
class="n">mname</span><span class="p">)</span> <span class="ow">and</span>
+ <span class="n">record_arguments</span><span
class="p">[</span><span class="s">u'admin_email'</span><span
class="p">]</span> <span class="o">==</span> <span
class="nb">unicode</span><span class="p">(</span><span
class="n">answer</span><span class="o">.</span><span
class="n">rname</span><span class="p">)</span> <span class="p">):</span>
+ <span class="n">good_records</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="n">record</span><span class="p">)</span>
+ <span class="k">break</span>
+
+ <span class="k">elif</span><span class="p">(</span> <span
class="n">record_type</span> <span class="o">==</span> <span
class="s">u'a'</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record_arguments</span><span class="p">[</span><span
class="s">u'assignment_ip'</span><span class="p">]</span> <span
class="o">==</span> <span class="n">answer</span><span
class="o">.</span><span class="n">address</span> <span class="p">):</span>
+ <span class="n">good_records</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="n">record</span><span class="p">)</span>
+ <span class="k">break</span>
+
+ <span class="k">elif</span><span class="p">(</span> <span
class="n">record_type</span> <span class="o">==</span> <span
class="s">u'aaaa'</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record_arguments</span><span class="p">[</span><span
class="s">u'assignment_ip'</span><span class="p">]</span> <span
class="o">==</span> <span class="n">helpers_lib</span><span
class="o">.</span><span class="n">ExpandIPV6</span><span class="p">(</span>
+ <span class="nb">unicode</span><span
class="p">(</span><span class="n">answer</span><span
class="o">.</span><span class="n">address</span><span class="p">))</span>
<span class="p">):</span>
+ <span class="n">good_records</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="n">record</span><span class="p">)</span>
+ <span class="k">break</span>
+
+ <span class="k">elif</span><span class="p">(</span> <span
class="n">record_type</span> <span class="o">==</span> <span
class="s">u'cname'</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record_arguments</span><span class="p">[</span><span
class="s">u'assignment_host'</span><span class="p">]</span> <span
class="o">==</span> <span class="nb">unicode</span><span
class="p">(</span><span class="n">answer</span><span
class="o">.</span><span class="n">target</span><span class="p">)</span>
<span class="p">):</span>
+ <span class="n">good_records</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="n">record</span><span class="p">)</span>
+ <span class="k">break</span>
+
+ <span class="k">elif</span><span class="p">(</span> <span
class="n">record_type</span> <span class="o">==</span> <span
class="s">u'ptr'</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record_arguments</span><span class="p">[</span><span
class="s">u'assignment_host'</span><span class="p">]</span> <span
class="o">==</span> <span class="nb">unicode</span><span
class="p">(</span><span class="n">answer</span><span
class="o">.</span><span class="n">target</span><span class="p">)</span>
<span class="p">):</span>
+ <span class="n">good_records</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="n">record</span><span class="p">)</span>
+ <span class="k">break</span>
+
+ <span class="k">elif</span><span class="p">(</span> <span
class="n">record_type</span> <span class="o">==</span> <span
class="s">u'mx'</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record_arguments</span><span class="p">[</span><span
class="s">u'priority'</span><span class="p">]</span> <span
class="o">==</span> <span class="n">answer</span><span
class="o">.</span><span class="n">preference</span> <span
class="ow">and</span>
+ <span class="n">record_arguments</span><span
class="p">[</span><span class="s">u'mail_server'</span><span
class="p">]</span> <span class="o">==</span> <span
class="nb">unicode</span><span class="p">(</span><span
class="n">answer</span><span class="o">.</span><span
class="n">exchange</span><span class="p">)</span> <span class="p">):</span>
+ <span class="n">good_records</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="n">record</span><span class="p">)</span>
+ <span class="k">break</span>
+
+ <span class="k">elif</span><span class="p">(</span> <span
class="n">record_type</span> <span class="o">==</span> <span
class="s">u'ns'</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record_arguments</span><span class="p">[</span><span
class="s">u'name_server'</span><span class="p">]</span> <span
class="o">==</span> <span class="nb">unicode</span><span
class="p">(</span><span class="n">answer</span><span
class="o">.</span><span class="n">target</span><span class="p">)</span>
<span class="p">):</span>
+ <span class="n">good_records</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="n">record</span><span class="p">)</span>
+ <span class="k">break</span>
+
+ <span class="k">elif</span><span class="p">(</span> <span
class="n">record_type</span> <span class="o">==</span> <span
class="s">u'hinfo'</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record_arguments</span><span class="p">[</span><span
class="s">u'hardware'</span><span class="p">]</span> <span
class="o">==</span> <span class="nb">unicode</span><span
class="p">(</span><span class="n">answer</span><span
class="o">.</span><span class="n">cpu</span><span class="p">)</span> <span
class="ow">and</span>
+ <span class="n">record_arguments</span><span
class="p">[</span><span class="s">u'os'</span><span
class="p">]</span> <span class="o">==</span> <span
class="nb">unicode</span><span class="p">(</span><span
class="n">answer</span><span class="o">.</span><span
class="n">os</span><span class="p">)</span> <span class="p">):</span>
+ <span class="n">good_records</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="n">record</span><span class="p">)</span>
+ <span class="k">break</span>
+
+ <span class="k">elif</span><span class="p">(</span> <span
class="n">record_type</span> <span class="o">==</span> <span
class="s">u'txt'</span> <span class="p">):</span>
+ <span class="n">quoted_text</span> <span class="o">=</span>
<span class="nb">unicode</span><span class="p">(</span><span
class="s">' '</span><span class="o">.</span><span
class="n">join</span><span class="p">(</span>
+ <span class="p">[</span><span
class="s">'"</span><span class="si">%s</span><span
class="s">"'</span> <span class="o">%</span> <span
class="n">answer_string</span> <span class="k">for</span> <span
class="n">answer_string</span> <span class="ow">in</span> <span
class="n">answer</span><span class="o">.</span><span
class="n">strings</span><span class="p">]))</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record_arguments</span><span class="p">[</span><span
class="s">u'quoted_text'</span><span class="p">]</span> <span
class="o">==</span> <span class="n">quoted_text</span> <span
class="p">):</span>
+ <span class="n">good_records</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="n">record</span><span class="p">)</span>
+ <span class="k">break</span>
+ <span class="k">elif</span><span class="p">(</span> <span
class="n">record_type</span> <span class="o">==</span> <span
class="s">u'srv'</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record_arguments</span><span class="p">[</span><span
class="s">'weight'</span><span class="p">]</span> <span
class="o">==</span> <span class="n">answer</span><span
class="o">.</span><span class="n">weight</span> <span class="ow">and</span>
+ <span class="n">record_arguments</span><span
class="p">[</span><span class="s">'priority'</span><span
class="p">]</span> <span class="o">==</span> <span
class="n">answer</span><span class="o">.</span><span
class="n">priority</span> <span class="ow">and</span>
+ <span class="n">record_arguments</span><span
class="p">[</span><span class="s">'assignment_host'</span><span
class="p">]</span> <span class="o">==</span> <span
class="nb">unicode</span><span class="p">(</span><span
class="n">answer</span><span class="o">.</span><span
class="n">target</span><span class="p">)</span> <span class="p">):</span>
+ <span class="n">good_records</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="n">record</span><span class="p">)</span>
+ <span class="k">break</span>
+
+ <span class="c">#Takes all the records that never made it into
good_records, and declares</span>
+ <span class="c">#them as bad_records.</span>
+ <span class="k">for</span> <span class="n">record</span> <span
class="ow">in</span> <span class="n">good_records</span><span
class="p">:</span>
+ <span class="n">records</span><span class="o">.</span><span
class="n">remove</span><span class="p">(</span><span
class="n">record</span><span class="p">)</span>
+
+ <span class="n">bad_records</span> <span class="o">=</span> <span
class="n">records</span>
+
+ <span class="c">#This is purely for asthetic reasons. If you were to
print bad_records,</span>
+ <span class="c">#you'd see a bunch of None's which doesn't
help you. It just clutters</span>
+ <span class="c">#the screen.</span>
+ <span class="k">for</span> <span class="n">record</span> <span
class="ow">in</span> <span class="n">bad_records</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="s">u'record_zone_name'</span> <span class="ow">in</span>
<span class="n">record</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record</span><span class="p">[</span><span
class="s">u'record_zone_name'</span><span class="p">]</span> <span
class="ow">is</span> <span class="bp">None</span> <span class="p">):</span>
+ <span class="k">del</span> <span class="n">record</span><span
class="p">[</span><span class="s">u'record_zone_name'</span><span
class="p">]</span>
+
+ <span class="k">return</span> <span class="p">(</span><span
class="n">good_records</span><span class="p">,</span> <span
class="n">bad_records</span><span class="p">)</span>
+</div>
+<div class="viewcode-block" id="QueryFromZoneFile"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.dns_query_lib.QueryFromZoneFile">[docs]</a><span
class="k">def</span> <span class="nf">QueryFromZoneFile</span><span
class="p">(</span><span class="n">zone_file_name</span><span
class="p">,</span> <span class="n">dns_server</span><span
class="p">,</span> <span class="n">port</span><span class="p">,</span>
<span class="n">records_to_query</span><span class="p">,</span>
+ <span class="n">view_name</span><span class="o">=</span><span
class="bp">None</span><span class="p">):</span>
+ <span class="sd">"""Queries a DNS server for a number of
records contained within the</span>
+<span class="sd"> supplied zone file.</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> zone_file_name: string of zone file path. e.g. -
'/tmp/forward_zone_1.db'</span>
+<span class="sd"> dns_server: string of IP Address or hostname of DNS
server.</span>
+<span class="sd"> port: int of port to query DNS server on. </span>
+<span class="sd"> num_records_to_query: int of the number of records to
randomly select and </span>
+<span class="sd"> query.</span>
+<span class="sd"> view_name: string of view that zone_file_name is
in.</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> True if all records queried, query
correctly."""</span>
+ <span class="n">zone_name</span> <span class="o">=</span> <span
class="n">zone_file_name</span><span class="o">.</span><span
class="n">split</span><span class="p">(</span><span
class="s">'/'</span><span class="p">)</span><span
class="o">.</span><span class="n">pop</span><span class="p">()</span><span
class="o">.</span><span class="n">split</span><span class="p">(</span><span
class="s">'.'</span><span class="p">)[</span><span
class="mi">0</span><span class="p">]</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">zone_file_handle</span> <span class="o">=</span> <span
class="nb">open</span><span class="p">(</span><span
class="n">zone_file_name</span><span class="p">,</span> <span
class="s">'r'</span><span class="p">)</span>
+ <span class="n">zone_file_string</span> <span class="o">=</span> <span
class="n">zone_file_handle</span><span class="o">.</span><span
class="n">read</span><span class="p">()</span>
+ <span class="n">zone_file_handle</span><span class="o">.</span><span
class="n">close</span><span class="p">()</span>
+ <span class="k">except</span> <span class="ne">IOError</span><span
class="p">:</span>
+ <span class="k">raise</span> <span class="n">config_lib</span><span
class="o">.</span><span class="n">QueryCheckError</span><span
class="p">(</span><span class="s">'Unable to open zone file '</span>
+ <span class="s">'</span><span
class="si">%s</span><span class="s">'</span> <span class="o">%</span>
<span class="n">zone_file_name</span><span class="p">)</span>
+
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">zone_object</span> <span class="o">=</span> <span
class="n">dns</span><span class="o">.</span><span
class="n">zone</span><span class="o">.</span><span
class="n">from_text</span><span class="p">(</span>
+ <span class="nb">str</span><span class="p">(</span><span
class="n">zone_file_string</span><span class="p">),</span> <span
class="n">check_origin</span><span class="o">=</span><span
class="bp">False</span><span class="p">)</span>
+ <span class="k">except</span> <span class="n">dns</span><span
class="o">.</span><span class="n">zone</span><span class="o">.</span><span
class="n">NoSOA</span><span class="p">:</span>
+ <span class="k">raise</span> <span class="n">config_lib</span><span
class="o">.</span><span class="n">QueryCheck</span><span
class="p">(</span><span class="s">'Zone has no SOA
record.'</span><span class="p">)</span>
+ <span class="k">except</span> <span class="n">dns</span><span
class="o">.</span><span class="n">zone</span><span class="o">.</span><span
class="n">NoNS</span><span class="p">:</span>
+ <span class="k">raise</span> <span class="n">config_lib</span><span
class="o">.</span><span class="n">QueryCheckError</span><span
class="p">(</span><span class="s">'Zone has no A/AAAA record for
NS'</span><span class="p">)</span>
+
+ <span class="n">zone_origin</span> <span class="o">=</span> <span
class="n">zone_object</span><span class="o">.</span><span
class="n">origin</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">all_zone_records_list</span> <span class="o">=</span>
<span class="n">helpers_lib</span><span class="o">.</span><span
class="n">CreateRecordsFromZoneObject</span><span class="p">(</span>
+ <span class="n">zone_object</span><span class="p">,</span> <span
class="n">zone_name</span><span class="o">=</span><span
class="n">zone_name</span><span class="p">,</span> <span
class="n">view_name</span><span class="o">=</span><span
class="n">view_name</span><span class="p">)</span>
+ <span class="k">except</span> <span class="n">errors</span><span
class="o">.</span><span class="n">UnexpectedDataError</span> <span
class="k">as</span> <span class="n">e</span><span class="p">:</span>
+ <span class="k">raise</span> <span class="n">config_lib</span><span
class="o">.</span><span class="n">QueryCheckError</span><span
class="p">(</span><span class="s">'Unexpected Data - </span><span
class="si">%s</span><span class="s">'</span> <span class="o">%</span>
<span class="n">e</span><span class="o">.</span><span
class="n">message</span><span class="p">())</span>
+ <span class="n">zone_records_list</span> <span class="o">=</span> <span
class="p">[]</span>
+
+ <span class="c">#Generating list of random records to query</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">records_to_query</span> <span class="o">==</span> <span
class="mi">0</span> <span class="p">):</span>
+ <span class="n">zone_records_list</span> <span class="o">=</span>
<span class="n">all_zone_records_list</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">for</span> <span class="n">i</span> <span
class="ow">in</span> <span class="nb">range</span><span
class="p">(</span><span class="n">records_to_query</span><span
class="p">):</span>
+ <span class="c">#If we've run out of records to pop, break out
of the loop</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="nb">len</span><span class="p">(</span><span
class="n">all_zone_records_list</span><span class="p">)</span> <span
class="o">==</span> <span class="mi">0</span> <span class="p">):</span>
+ <span class="k">break</span>
+
+ <span class="n">random_record_index</span> <span class="o">=</span>
<span class="n">random</span><span class="o">.</span><span
class="n">randint</span><span class="p">(</span><span
class="mi">0</span><span class="p">,</span> <span
class="nb">len</span><span class="p">(</span><span
class="n">all_zone_records_list</span><span class="p">)</span> <span
class="o">-</span> <span class="mi">1</span><span class="p">)</span>
+ <span class="n">random_record</span> <span class="o">=</span> <span
class="n">all_zone_records_list</span><span class="o">.</span><span
class="n">pop</span><span class="p">(</span><span
class="n">random_record_index</span><span class="p">)</span>
+ <span class="n">zone_records_list</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="n">random_record</span><span
class="p">)</span>
+
+ <span class="p">(</span><span class="n">good_records</span><span
class="p">,</span> <span class="n">bad_records</span><span
class="p">)</span> <span class="o">=</span> <span
class="n">DnsQuery</span><span class="p">(</span>
+ <span class="n">zone_records_list</span><span class="p">,</span>
<span class="n">dns_server</span><span class="p">,</span> <span
class="n">port</span><span class="p">,</span> <span
class="n">zone_origin</span><span class="p">)</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="nb">len</span><span class="p">(</span><span
class="n">bad_records</span><span class="p">)</span> <span
class="o">!=</span> <span class="mi">0</span> <span class="p">):</span>
+ <span class="k">return</span> <span class="bp">False</span>
+ <span class="k">return</span> <span class="bp">True</span>
+</pre></div></div>
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="../../search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../../genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ <li><a href="../index.html" >Module code</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2013, Purdue University.
+ Created using <a href="
http://sphinx-doc.org/">Sphinx</a> 1.2b1.
+ </div>
+ </body>
+</html>
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager/tree_exporter.html
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,1020 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="
http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>roster_config_manager.tree_exporter — Roster Config
Manager v0.18 documentation</title>
+
+ <link rel="stylesheet" href="../../_static/default.css"
type="text/css" />
+ <link rel="stylesheet" href="../../_static/pygments.css"
type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: '../../',
+ VERSION: 'v0.18',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="../../_static/jquery.js"></script>
+ <script type="text/javascript"
src="../../_static/underscore.js"></script>
+ <script type="text/javascript"
src="../../_static/doctools.js"></script>
+ <link rel="top" title="Roster Config Manager v0.18 documentation"
href="../../index.html" />
+ <link rel="up" title="Module code" href="../index.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../../genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ <li><a href="../index.html" accesskey="U">Module code</a>
»</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <h1>Source code for roster_config_manager.tree_exporter</h1><div
class="highlight"><pre>
+<span class="c">#!/usr/bin/python</span>
+
+<span class="c"># Copyright (c) 2009, Purdue University</span>
+<span class="c"># All rights reserved.</span>
+<span class="c">#</span>
+<span class="c"># Redistribution and use in source and binary forms, with
or without</span>
+<span class="c"># modification, are permitted provided that the following
conditions are met:</span>
+<span class="c">#</span>
+<span class="c"># Redistributions of source code must retain the above
copyright notice, this</span>
+<span class="c"># list of conditions and the following disclaimer.</span>
+<span class="c">#</span>
+<span class="c"># Redistributions in binary form must reproduce the above
copyright notice, this</span>
+<span class="c"># list of conditions and the following disclaimer in the
documentation and/or</span>
+<span class="c"># other materials provided with the distribution.</span>
+<span class="c">#</span>
+<span class="c"># Neither the name of the Purdue University nor the names
of its contributors</span>
+<span class="c"># may be used to endorse or promote products derived from
this software without</span>
+<span class="c"># specific prior written permission.</span>
+<span class="c">#</span>
+<span class="c"># THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS"</span>
+<span class="c"># AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
NOT LIMITED TO, THE</span>
+<span class="c"># IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE</span>
+<span class="c"># DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
CONTRIBUTORS BE LIABLE</span>
+<span class="c"># FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL</span>
+<span class="c"># DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR</span>
+<span class="c"># SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER</span>
+<span class="c"># CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY,</span>
+<span class="c"># OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE</span>
+<span class="c"># OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.</span>
+
+
+<span class="sd">"""This module is used for exporting data
in the database for all hosts</span>
+<span class="sd">to a BIND readable text form.</span>
+<span class="sd">"""</span>
+
+<span class="n">__copyright__</span> <span class="o">=</span> <span
class="s">'Copyright (C) 2009, Purdue University'</span>
+<span class="n">__license__</span> <span class="o">=</span> <span
class="s">'BSD'</span>
+<span class="n">__version__</span> <span class="o">=</span> <span
class="s">'#TRUNK#'</span>
+
+
+<span class="kn">import</span> <span class="nn">bz2</span>
+<span class="kn">import</span> <span class="nn">ConfigParser</span>
+<span class="kn">import</span> <span class="nn">datetime</span>
+<span class="kn">import</span> <span class="nn">iscpy</span>
+<span class="kn">import</span> <span class="nn">os</span>
+<span class="kn">import</span> <span class="nn">StringIO</span>
+<span class="kn">import</span> <span class="nn">shutil</span>
+<span class="kn">import</span> <span class="nn">tarfile</span>
+
+<span class="kn">from</span> <span class="nn">roster_core</span> <span
class="kn">import</span> <span class="n">punycode_lib</span>
+<span class="kn">from</span> <span class="nn">roster_core</span> <span
class="kn">import</span> <span class="n">audit_log</span>
+<span class="kn">from</span> <span class="nn">roster_core</span> <span
class="kn">import</span> <span class="n">config</span>
+<span class="kn">from</span> <span class="nn">roster_core</span> <span
class="kn">import</span> <span class="n">constants</span>
+<span class="kn">from</span> <span class="nn">roster_core</span> <span
class="kn">import</span> <span class="n">core</span>
+<span class="kn">from</span> <span class="nn">roster_core</span> <span
class="kn">import</span> <span class="n">errors</span>
+<span class="kn">from</span> <span class="nn">roster_core</span> <span
class="kn">import</span> <span class="n">helpers_lib</span>
+<span class="kn">from</span> <span class="nn">roster_config_manager</span>
<span class="kn">import</span> <span class="n">config_lib</span>
+<span class="kn">from</span> <span class="nn">roster_config_manager</span>
<span class="kn">import</span> <span class="n">zone_exporter_lib</span>
+
+
+<span class="n">core</span><span class="o">.</span><span
class="n">CheckCoreVersionMatches</span><span class="p">(</span><span
class="n">__version__</span><span class="p">)</span>
+
+
+<div class="viewcode-block" id="Error"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.Error">[docs]</a><span
class="k">class</span> <span class="nc">Error</span><span
class="p">(</span><span class="n">errors</span><span
class="o">.</span><span class="n">CoreError</span><span class="p">):</span>
+ <span class="k">pass</span>
+
+</div>
+<div class="viewcode-block" id="MaintenanceError"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.MaintenanceError">[docs]</a><span
class="k">class</span> <span class="nc">MaintenanceError</span><span
class="p">(</span><span class="n">Error</span><span class="p">):</span>
+ <span class="k">pass</span>
+
+</div>
+<div class="viewcode-block" id="ChangesNotFoundError"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.ChangesNotFoundError">[docs]</a><span
class="k">class</span> <span class="nc">ChangesNotFoundError</span><span
class="p">(</span><span class="n">Error</span><span class="p">):</span>
+ <span class="k">pass</span>
+
+</div>
+<div class="viewcode-block" id="BindTreeExport"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport">[docs]</a><span
class="k">class</span> <span class="nc">BindTreeExport</span><span
class="p">(</span><span class="nb">object</span><span class="p">):</span>
+ <span class="sd">"""This class exports
zones"""</span>
+ <span class="k">def</span> <span class="nf">__init__</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">config_file_name</span><span class="p">):</span>
+ <span class="sd">"""Sets self.db_instance</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> config_file_name: name of config file to load db
info from</span>
+<span class="sd"> """</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">tar_file_name</span> <span class="o">=</span> <span
class="s">''</span>
+ <span class="n">config_instance</span> <span class="o">=</span> <span
class="n">config</span><span class="o">.</span><span
class="n">Config</span><span class="p">(</span><span
class="n">file_name</span><span class="o">=</span><span
class="n">config_file_name</span><span class="p">)</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span> <span class="o">=</span> <span
class="n">config_instance</span><span class="o">.</span><span
class="n">GetDb</span><span class="p">()</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">config_lib_instance</span> <span class="o">=</span> <span
class="n">config_lib</span><span class="o">.</span><span
class="n">ConfigLib</span><span class="p">(</span><span
class="n">config_file_name</span><span class="p">)</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">raw_data</span> <span class="o">=</span> <span class="p">{}</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">cooked_data</span> <span class="o">=</span> <span
class="p">{}</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span> <span class="o">=</span> <span
class="n">config_instance</span><span class="o">.</span><span
class="n">config_file</span><span class="p">[</span><span
class="s">'exporter'</span><span class="p">][</span>
+ <span class="s">'root_config_dir'</span><span
class="p">]</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span> <span class="o">=</span> <span
class="n">os</span><span class="o">.</span><span class="n">path</span><span
class="o">.</span><span class="n">abspath</span><span
class="p">(</span><span class="n">os</span><span class="o">.</span><span
class="n">path</span><span class="o">.</span><span
class="n">expanduser</span><span class="p">(</span>
+ <span class="n">config_instance</span><span
class="o">.</span><span class="n">config_file</span><span
class="p">[</span><span class="s">'exporter'</span><span
class="p">][</span><span class="s">'backup_dir'</span><span
class="p">]))</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">root_hint_file</span> <span class="o">=</span> <span
class="n">os</span><span class="o">.</span><span class="n">path</span><span
class="o">.</span><span class="n">abspath</span><span
class="p">(</span><span class="n">os</span><span class="o">.</span><span
class="n">path</span><span class="o">.</span><span
class="n">expanduser</span><span class="p">(</span>
+ <span class="n">config_instance</span><span
class="o">.</span><span class="n">config_file</span><span
class="p">[</span><span class="s">'exporter'</span><span
class="p">][</span><span class="s">'root_hint_file'</span><span
class="p">]))</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">log_instance</span> <span class="o">=</span> <span
class="n">audit_log</span><span class="o">.</span><span
class="n">AuditLog</span><span class="p">(</span><span
class="n">log_to_syslog</span><span class="o">=</span><span
class="bp">True</span><span class="p">,</span> <span
class="n">log_to_db</span><span class="o">=</span><span
class="bp">True</span><span class="p">,</span>
+ <span
class="n">db_instance</span><span class="o">=</span><span
class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="p">)</span>
+
+<div class="viewcode-block"
id="BindTreeExport.NamedHeaderChangeDirectory"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.NamedHeaderChangeDirectory">[docs]</a>
<span class="k">def</span> <span
class="nf">NamedHeaderChangeDirectory</span><span class="p">(</span><span
class="bp">self</span><span class="p">,</span> <span
class="n">named_conf_header</span><span class="p">,</span> <span
class="n">new_directory</span><span class="p">):</span>
+ <span class="sd">"""Adds/Changes directory in
named.conf header</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> named_conf_header: string of namedconf header</span>
+<span class="sd"> new_directory: {}</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> string: string of namedconf header</span>
+<span class="sd"> """</span>
+ <span class="n">named_conf_header_contents</span> <span
class="o">=</span> <span class="n">iscpy</span><span
class="o">.</span><span class="n">ParseISCString</span><span
class="p">(</span><span class="n">named_conf_header</span><span
class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'options'</span> <span class="ow">not</span> <span
class="ow">in</span> <span class="n">named_conf_header_contents</span>
<span class="p">):</span>
+ <span class="n">named_conf_header_contents</span><span
class="p">[</span><span class="s">'options'</span><span
class="p">]</span> <span class="o">=</span> <span class="p">{}</span>
+ <span class="n">named_conf_header_contents</span><span
class="p">[</span><span class="s">'options'</span><span
class="p">][</span><span class="s">'directory'</span><span
class="p">]</span> <span class="o">=</span> <span
class="s">'"</span><span class="si">%s</span><span
class="s">"'</span> <span class="o">%</span> <span
class="n">new_directory</span>
+ <span class="k">return</span> <span class="n">iscpy</span><span
class="o">.</span><span class="n">MakeISC</span><span
class="p">(</span><span class="n">named_conf_header_contents</span><span
class="p">)</span>
+
+</div>
+<div class="viewcode-block" id="BindTreeExport.AddToTarFile"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.AddToTarFile">[docs]</a>
<span class="k">def</span> <span class="nf">AddToTarFile</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">tar_file</span><span class="p">,</span> <span
class="n">file_name</span><span class="p">,</span> <span
class="n">file_string</span><span class="p">):</span>
+ <span class="sd">"""Adds file string to tarfile
object</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> tarfile: tarfile object</span>
+<span class="sd"> file_name: string of filename to add</span>
+<span class="sd"> file_string: string of file</span>
+<span class="sd"> """</span>
+ <span class="n">info</span> <span class="o">=</span> <span
class="n">tarfile</span><span class="o">.</span><span
class="n">TarInfo</span><span class="p">(</span><span
class="n">name</span><span class="o">=</span><span
class="n">file_name</span><span class="p">)</span>
+ <span class="n">info</span><span class="o">.</span><span
class="n">size</span> <span class="o">=</span> <span
class="nb">len</span><span class="p">(</span><span
class="n">file_string</span><span class="p">)</span>
+ <span class="n">tar_file</span><span class="o">.</span><span
class="n">addfile</span><span class="p">(</span><span
class="n">info</span><span class="p">,</span> <span
class="n">StringIO</span><span class="o">.</span><span
class="n">StringIO</span><span class="p">(</span><span
class="n">file_string</span><span class="p">))</span>
+</div>
+<div class="viewcode-block"
id="BindTreeExport.ListRecordArgumentDefinitions"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.ListRecordArgumentDefinitions">[docs]</a>
<span class="k">def</span> <span
class="nf">ListRecordArgumentDefinitions</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">record_arguments</span><span class="p">):</span>
+ <span class="sd">"""Lists record argument definitions
given table from database</span>
+
+<span class="sd"> This function is duplicated in
roster-core/roster_core/core.py</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> record_arguments: record arguments from
database</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> dictionary keyed by record type with values of
lists</span>
+<span class="sd"> of lists of record arguments sorted by argument
order.</span>
+<span class="sd"> example: {'mx':
[{'argument_name': u'priority',</span>
+<span class="sd">
'record_arguments_type': u'mx',</span>
+<span class="sd"> 'argument_data_type':
u'UnsignedInt',</span>
+<span class="sd"> 'argument_order':
0},</span>
+<span class="sd"> {'argument_name':
u'mail_server',</span>
+<span class="sd">
'record_arguments_type': u'mx',</span>
+<span class="sd"> 'argument_data_type':
u'Hostname',</span>
+<span class="sd"> 'argument_order':
1}]}</span>
+<span class="sd"> """</span>
+ <span class="n">sorted_record_arguments</span> <span
class="o">=</span> <span class="p">{}</span>
+ <span class="k">for</span> <span class="n">record_argument</span>
<span class="ow">in</span> <span class="n">record_arguments</span><span
class="p">:</span>
+ <span class="n">current_record_type</span> <span class="o">=</span>
<span class="n">record_argument</span><span class="p">[</span><span
class="s">'record_arguments_type'</span><span class="p">]</span>
+ <span class="k">del</span> <span
class="n">record_argument</span><span class="p">[</span><span
class="s">'record_arguments_type'</span><span class="p">]</span>
+ <span class="k">del</span> <span
class="n">record_argument</span><span class="p">[</span><span
class="s">'argument_data_type'</span><span class="p">]</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">current_record_type</span> <span
class="ow">in</span> <span class="n">sorted_record_arguments</span> <span
class="p">):</span>
+ <span class="n">sorted_record_arguments</span><span
class="p">[</span><span class="n">current_record_type</span><span
class="p">]</span> <span class="o">=</span> <span class="p">[]</span>
+ <span class="n">sorted_record_arguments</span><span
class="p">[</span><span class="n">current_record_type</span><span
class="p">]</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="n">record_argument</span><span class="p">)</span>
+ <span class="k">for</span> <span class="n">record_argument</span>
<span class="ow">in</span> <span
class="n">sorted_record_arguments</span><span class="p">:</span>
+ <span class="n">sorted_record_arguments</span><span
class="p">[</span><span class="n">record_argument</span><span
class="p">]</span> <span class="o">=</span> <span
class="nb">sorted</span><span class="p">(</span>
+ <span class="n">sorted_record_arguments</span><span
class="p">[</span><span class="n">record_argument</span><span
class="p">],</span>
+ <span class="n">key</span><span class="o">=</span><span
class="k">lambda</span> <span class="n">k</span><span class="p">:</span>
<span class="n">k</span><span class="p">[</span><span
class="s">'argument_order'</span><span class="p">])</span>
+ <span class="k">return</span> <span
class="n">sorted_record_arguments</span>
+</div>
+<div class="viewcode-block" id="BindTreeExport.ExportAllBindTrees"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.ExportAllBindTrees">[docs]</a>
<span class="k">def</span> <span class="nf">ExportAllBindTrees</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">force</span><span class="o">=</span><span
class="bp">False</span><span class="p">):</span>
+ <span class="sd">"""Exports bind trees to files</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> force: boolean of if the export should continue if
no changes are found</span>
+<span class="sd"> in the database</span>
+<span class="sd"> """</span>
+ <span class="n">function_name</span><span class="p">,</span> <span
class="n">current_args</span> <span class="o">=</span> <span
class="n">helpers_lib</span><span class="o">.</span><span
class="n">GetFunctionNameAndArgs</span><span class="p">()</span>
+ <span class="n">success</span> <span class="o">=</span> <span
class="bp">False</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">StartTransaction</span><span class="p">()</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">LockDb</span><span class="p">()</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">force</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">CheckMaintenanceFlag</span><span class="p">()</span> <span
class="p">):</span>
+ <span class="k">raise</span> <span
class="n">MaintenanceError</span><span class="p">(</span><span
class="s">'Database currently under maintenance.'</span><span
class="p">)</span>
+ <span class="n">audit_log_dict</span> <span class="o">=</span>
<span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">GetEmptyRowDict</span><span class="p">(</span><span
class="s">'audit_log'</span><span class="p">)</span>
+ <span class="n">audit_log_dict</span><span
class="p">[</span><span class="s">'action'</span><span
class="p">]</span> <span class="o">=</span> <span
class="s">u'ExportAllBindTrees'</span>
+ <span class="n">audit_log_dict</span><span
class="p">[</span><span class="s">'success'</span><span
class="p">]</span> <span class="o">=</span> <span class="mi">1</span>
+ <span class="n">audit_rows</span> <span class="o">=</span>
<span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">ListRow</span><span class="p">(</span><span
class="s">'audit_log'</span><span class="p">,</span> <span
class="n">audit_log_dict</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">audit_rows</span> <span class="p">):</span>
+ <span class="n">audit_rows</span> <span class="o">=</span>
<span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">ListRow</span><span class="p">(</span>
+ <span class="s">'audit_log'</span><span
class="p">,</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">GetEmptyRowDict</span><span
class="p">(</span><span class="s">'audit_log'</span><span
class="p">),</span>
+ <span class="n">column</span><span
class="o">=</span><span class="s">'audit_log_timestamp'</span><span
class="p">,</span>
+ <span class="n">range_values</span><span
class="o">=</span><span class="p">(</span><span
class="n">audit_rows</span><span class="p">[</span><span
class="o">-</span><span class="mi">1</span><span class="p">][</span><span
class="s">'audit_log_timestamp'</span><span class="p">],</span>
+ <span class="n">datetime</span><span
class="o">.</span><span class="n">datetime</span><span
class="o">.</span><span class="n">now</span><span class="p">()),</span>
+ <span class="n">is_date</span><span
class="o">=</span><span class="bp">True</span><span class="p">)</span>
+ <span class="k">for</span> <span class="n">row</span> <span
class="ow">in</span> <span class="n">audit_rows</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">row</span><span class="p">[</span><span
class="s">'action'</span><span class="p">]</span> <span
class="o">!=</span> <span class="s">u'ExportAllBindTrees'</span>
<span class="p">):</span>
+ <span class="k">break</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">ChangesNotFoundError</span><span class="p">(</span><span
class="s">'No changes have been made to the '</span>
+ <span class="s">'database
since last export, '</span>
+ <span class="s">'no export
needed.'</span><span class="p">)</span>
+ <span class="n">data</span><span class="p">,</span> <span
class="n">raw_dump</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">GetRawData</span><span class="p">()</span>
+ <span class="n">current_time</span> <span class="o">=</span>
<span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">GetCurrentTime</span><span class="p">()</span>
+ <span class="k">finally</span><span class="p">:</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">UnlockDb</span><span class="p">()</span>
+ <span class="k">finally</span><span class="p">:</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">EndTransaction</span><span class="p">()</span>
+ <span class="n">cooked_data</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">CookData</span><span class="p">(</span><span
class="n">data</span><span class="p">)</span>
+ <span class="n">zone_view_assignments</span> <span
class="o">=</span> <span class="p">{}</span>
+ <span class="k">for</span> <span
class="n">zone_view_assignment</span> <span class="ow">in</span> <span
class="n">data</span><span class="p">[</span><span
class="s">'zone_view_assignments'</span><span class="p">]:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">zone_view_assignment</span><span
class="p">[</span><span
class="s">'zone_view_assignments_zone_name'</span><span
class="p">]</span>
+ <span class="ow">in</span> <span
class="n">zone_view_assignments</span><span class="p">):</span>
+ <span class="n">zone_view_assignments</span><span
class="p">[</span><span class="n">zone_view_assignment</span><span
class="p">[</span>
+ <span
class="s">'zone_view_assignments_zone_name'</span><span
class="p">]]</span> <span class="o">=</span> <span class="p">[]</span>
+ <span class="n">zone_view_assignments</span><span
class="p">[</span><span class="n">zone_view_assignment</span><span
class="p">[</span>
+ <span
class="s">'zone_view_assignments_zone_name'</span><span
class="p">]]</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="n">zone_view_assignment</span><span class="p">[</span>
+ <span
class="s">'zone_view_assignments_view_dependency'</span><span
class="p">]</span><span class="o">.</span><span class="n">split</span><span
class="p">(</span><span class="s">'_dep'</span><span
class="p">)[</span><span class="mi">0</span><span class="p">])</span>
+ <span class="k">for</span> <span
class="n">zone_view_assignment</span> <span class="ow">in</span> <span
class="n">zone_view_assignments</span><span class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">zone_view_assignments</span><span class="p">[</span><span
class="n">zone_view_assignment</span><span class="p">]</span> <span
class="o">==</span> <span class="p">[</span><span
class="s">u'any'</span><span class="p">]</span> <span
class="p">):</span>
+ <span class="k">raise</span> <span class="n">Error</span><span
class="p">(</span><span class="s">'Zone "</span><span
class="si">%s</span><span class="s">" has no view
assignments.'</span> <span class="o">%</span>
+ <span class="n">zone_view_assignment</span><span
class="p">)</span>
+
+ <span class="n">record_arguments</span> <span class="o">=</span>
<span class="n">data</span><span class="p">[</span><span
class="s">'record_arguments'</span><span class="p">]</span>
+ <span class="n">record_argument_definitions</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">ListRecordArgumentDefinitions</span><span
class="p">(</span>
+ <span class="n">record_arguments</span><span class="p">)</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="nb">len</span><span class="p">(</span><span
class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">])</span> <span
class="o">==</span> <span class="mi">0</span> <span class="p">):</span>
+ <span class="k">raise</span> <span class="n">Error</span><span
class="p">(</span><span class="s">'No dns server sets
found.'</span><span class="p">)</span>
+ <span class="k">for</span> <span class="n">dns_server_set</span>
<span class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">]:</span>
+ <span class="k">for</span> <span class="n">dns_server</span> <span
class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set</span><span
class="p">][</span>
+ <span class="s">'dns_servers'</span><span
class="p">]:</span>
+ <span class="n">dummy_config_file</span> <span
class="o">=</span> <span class="n">StringIO</span><span
class="o">.</span><span class="n">StringIO</span><span class="p">()</span>
+ <span class="n">config_parser</span> <span class="o">=</span>
<span class="n">ConfigParser</span><span class="o">.</span><span
class="n">SafeConfigParser</span><span class="p">()</span>
+
+ <span class="c">## Make Files</span>
+ <span class="n">named_directory</span> <span class="o">=</span>
<span class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="o">.</span><span
class="n">rstrip</span><span class="p">(</span><span
class="s">'/'</span><span class="p">),</span> <span
class="n">dns_server</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">os</span><span
class="o">.</span><span class="n">path</span><span class="o">.</span><span
class="n">exists</span><span class="p">(</span><span
class="n">named_directory</span><span class="p">)</span> <span
class="p">):</span>
+ <span class="n">os</span><span class="o">.</span><span
class="n">makedirs</span><span class="p">(</span><span
class="n">named_directory</span><span class="p">)</span>
+ <span class="n">dns_server_directory</span> <span
class="o">=</span> <span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span
class="s">/named'</span> <span class="o">%</span> <span
class="p">(</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">root_config_dir</span><span class="o">.</span><span
class="n">rstrip</span><span class="p">(</span><span
class="s">'/'</span><span class="p">),</span> <span
class="n">dns_server</span><span class="p">))</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">os</span><span
class="o">.</span><span class="n">path</span><span class="o">.</span><span
class="n">exists</span><span class="p">(</span><span
class="n">dns_server_directory</span><span class="p">)</span> <span
class="p">):</span>
+ <span class="n">os</span><span class="o">.</span><span
class="n">makedirs</span><span class="p">(</span><span
class="n">dns_server_directory</span><span class="p">)</span>
+
+ <span class="c"># Write server info file</span>
+ <span class="n">bind_dir</span> <span class="o">=</span> <span
class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_servers'</span><span class="p">][</span><span
class="n">dns_server</span><span class="p">][</span>
+ <span
class="s">'dns_server_remote_bind_directory'</span><span
class="p">]</span>
+
+ <span class="n">info_file_dict</span> <span class="o">=</span>
<span class="p">{</span>
+ <span class="s">'server_info'</span><span
class="p">:</span> <span class="p">{</span>
+ <span class="s">'server_name'</span><span
class="p">:</span> <span class="n">dns_server</span><span class="p">,</span>
+ <span class="s">'server_user'</span><span
class="p">:</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_servers'</span><span
class="p">][</span><span class="n">dns_server</span><span
class="p">][</span>
+ <span
class="s">'dns_server_ssh_username'</span><span class="p">],</span>
+ <span class="s">'bind_dir'</span><span
class="p">:</span> <span class="n">bind_dir</span><span class="p">,</span>
+ <span class="s">'test_dir'</span><span
class="p">:</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_servers'</span><span
class="p">][</span><span class="n">dns_server</span><span
class="p">][</span>
+ <span
class="s">'dns_server_remote_test_directory'</span><span
class="p">],</span>
+ <span class="s">'bind_version'</span><span
class="p">:</span> <span class="s">'undetermined'</span><span
class="p">},</span>
+ <span class="s">'tools'</span><span
class="p">:</span> <span class="p">{</span>
+ <span class="s">'tar'</span><span
class="p">:</span> <span class="s">'True'</span><span
class="p">}}</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">config_lib_instance</span><span class="o">.</span><span
class="n">WriteDnsServerInfo</span><span class="p">(</span><span
class="n">info_file_dict</span><span class="p">)</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="nb">len</span><span class="p">(</span><span
class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set</span><span class="p">][</span>
+ <span class="s">'views'</span><span
class="p">])</span> <span class="o">==</span> <span class="mi">0</span>
<span class="p">):</span>
+ <span class="k">raise</span> <span class="n">Error</span><span
class="p">(</span><span class="s">'Server set </span><span
class="si">%s</span><span class="s"> has no views.'</span> <span
class="o">%</span> <span class="n">dns_server_set</span><span
class="p">)</span>
+ <span class="k">for</span> <span class="n">view</span> <span
class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">]:</span>
+ <span class="n">view_directory</span> <span class="o">=</span>
<span class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="n">dns_server_directory</span><span class="p">,</span> <span
class="n">view</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">os</span><span
class="o">.</span><span class="n">path</span><span class="o">.</span><span
class="n">exists</span><span class="p">(</span><span
class="n">view_directory</span><span class="p">)</span> <span
class="p">):</span>
+ <span class="n">os</span><span class="o">.</span><span
class="n">makedirs</span><span class="p">(</span><span
class="n">view_directory</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="nb">len</span><span class="p">(</span><span
class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set</span><span class="p">][</span><span
class="s">'views'</span><span class="p">][</span>
+ <span class="n">view</span><span class="p">][</span><span
class="s">'zones'</span><span class="p">])</span> <span
class="o">==</span> <span class="mi">0</span> <span class="p">):</span>
+ <span class="k">raise</span> <span
class="n">Error</span><span class="p">(</span><span class="s">'Server
set </span><span class="si">%s</span><span class="s"> has no zones in
</span><span class="si">%s</span><span class="s"> view.'</span> <span
class="o">%</span> <span class="p">(</span>
+ <span class="n">dns_server_set</span><span
class="p">,</span> <span class="n">view</span><span class="p">))</span>
+ <span class="k">for</span> <span class="n">zone</span> <span
class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span>
+ <span class="n">view</span><span class="p">][</span><span
class="s">'zones'</span><span class="p">]:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">view</span> <span class="ow">not</span> <span
class="ow">in</span> <span class="n">zone_view_assignments</span><span
class="p">[</span><span class="n">zone</span><span class="p">]</span> <span
class="p">):</span>
+ <span class="k">continue</span>
+ <span class="k">if</span><span class="p">(</span><span
class="ow">not</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span>
+ <span class="n">view</span><span
class="p">][</span><span class="s">'zones'</span><span
class="p">][</span><span class="n">zone</span><span
class="p">][</span><span class="s">'records'</span><span
class="p">]):</span>
+ <span class="k">continue</span>
+
+ <span class="n">zone_file</span> <span class="o">=</span>
<span class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">/</span><span
class="si">%s</span><span class="s">.db'</span> <span
class="o">%</span> <span class="p">(</span><span
class="n">dns_server_directory</span><span class="p">,</span> <span
class="n">view</span><span class="p">,</span> <span
class="n">zone</span><span class="p">)</span>
+ <span class="n">zone_file_string</span> <span
class="o">=</span> <span class="n">zone_exporter_lib</span><span
class="o">.</span><span class="n">MakeZoneString</span><span
class="p">(</span>
+ <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span><span class="n">view</span><span class="p">][</span>
+ <span class="s">'zones'</span><span
class="p">][</span><span class="n">zone</span><span
class="p">][</span><span class="s">'records'</span><span
class="p">],</span>
+ <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span><span class="n">view</span><span class="p">][</span>
+ <span class="s">'zones'</span><span
class="p">][</span><span class="n">zone</span><span
class="p">][</span><span class="s">'zone_origin'</span><span
class="p">],</span>
+ <span class="n">record_argument_definitions</span><span
class="p">,</span> <span class="n">zone</span><span class="p">,</span>
<span class="n">view</span><span class="p">)</span>
+ <span class="n">zone_file_handle</span> <span
class="o">=</span> <span class="nb">open</span><span
class="p">(</span><span class="n">zone_file</span><span class="p">,</span>
<span class="s">'w'</span><span class="p">)</span>
+ <span class="n">zone_file_handle</span><span
class="o">.</span><span class="n">write</span><span class="p">(</span><span
class="n">zone_file_string</span><span class="p">)</span>
+ <span class="n">zone_file_handle</span><span
class="o">.</span><span class="n">close</span><span class="p">()</span>
+
+ <span class="c"># Write named conf files</span>
+ <span class="n">named_conf_file</span> <span class="o">=</span>
<span class="n">os</span><span class="o">.</span><span
class="n">path</span><span class="o">.</span><span
class="n">join</span><span class="p">(</span><span
class="n">named_directory</span><span class="p">,</span> <span
class="s">'named.conf.a'</span><span class="p">)</span>
+ <span class="n">named_conf_binary_file</span> <span
class="o">=</span> <span class="n">os</span><span class="o">.</span><span
class="n">path</span><span class="o">.</span><span
class="n">join</span><span class="p">(</span><span
class="n">named_directory</span><span class="p">,</span> <span
class="s">'named.conf.b'</span><span class="p">)</span>
+ <span class="n">named_conf_a_file_string</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">MakeNamedConf</span><span
class="p">(</span><span class="n">data</span><span class="p">,</span> <span
class="n">cooked_data</span><span class="p">,</span>
+ <span
class="n">dns_server_set</span><span class="p">,</span> <span
class="s">'db'</span><span class="p">,</span>
+ <span
class="n">bind_dir</span><span class="p">)</span>
+ <span class="n">named_conf_b_file_string</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">MakeNamedConf</span><span
class="p">(</span><span class="n">data</span><span class="p">,</span> <span
class="n">cooked_data</span><span class="p">,</span>
+ <span
class="n">dns_server_set</span><span class="p">,</span> <span
class="s">'aa'</span><span class="p">,</span>
+ <span
class="n">bind_dir</span><span class="p">,</span> <span
class="n">binary</span><span class="o">=</span><span
class="bp">True</span><span class="p">)</span>
+ <span class="n">root_hint_file</span> <span class="o">=</span>
<span class="n">os</span><span class="o">.</span><span
class="n">path</span><span class="o">.</span><span
class="n">join</span><span class="p">(</span><span
class="n">named_directory</span><span class="p">,</span> <span
class="s">'named/
named.ca'</span><span class="p">)</span>
+ <span class="n">root_hint_file_string</span> <span
class="o">=</span> <span class="nb">open</span><span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">root_hint_file</span><span class="p">,</span> <span
class="s">'r'</span><span class="p">)</span><span
class="o">.</span><span class="n">read</span><span class="p">()</span>
+ <span class="n">root_hint_file_handle</span> <span
class="o">=</span> <span class="nb">open</span><span
class="p">(</span><span class="n">root_hint_file</span><span
class="p">,</span> <span class="s">'w'</span><span
class="p">)</span>
+ <span class="n">named_conf_binary_file_handle</span> <span
class="o">=</span> <span class="nb">open</span><span
class="p">(</span><span class="n">named_conf_binary_file</span><span
class="p">,</span> <span class="s">'w'</span><span
class="p">)</span>
+ <span class="n">named_conf_file_handle</span> <span
class="o">=</span> <span class="nb">open</span><span
class="p">(</span><span class="n">named_conf_file</span><span
class="p">,</span> <span class="s">'w'</span><span
class="p">)</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">named_conf_file_handle</span><span
class="o">.</span><span class="n">write</span><span class="p">(</span><span
class="n">named_conf_a_file_string</span><span class="p">)</span>
+ <span class="n">named_conf_binary_file_handle</span><span
class="o">.</span><span class="n">write</span><span class="p">(</span><span
class="n">named_conf_b_file_string</span><span class="p">)</span>
+ <span class="n">root_hint_file_handle</span><span
class="o">.</span><span class="n">write</span><span class="p">(</span><span
class="n">root_hint_file_string</span><span class="p">)</span>
+ <span class="k">finally</span><span class="p">:</span>
+ <span class="n">named_conf_file_handle</span><span
class="o">.</span><span class="n">close</span><span class="p">()</span>
+ <span class="n">named_conf_binary_file_handle</span><span
class="o">.</span><span class="n">close</span><span class="p">()</span>
+ <span class="n">root_hint_file_handle</span><span
class="o">.</span><span class="n">close</span><span class="p">()</span>
+
+
+ <span class="n">audit_log_replay_dump</span><span class="p">,</span>
<span class="n">full_database_dump</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">CookRawDump</span><span class="p">(</span><span
class="n">raw_dump</span><span class="p">)</span>
+
+ <span class="n">success</span> <span class="o">=</span> <span
class="bp">True</span>
+ <span class="k">finally</span><span class="p">:</span>
+ <span class="n">log_id</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">log_instance</span><span class="o">.</span><span
class="n">LogAction</span><span class="p">(</span><span
class="s">u'tree_export_user'</span><span class="p">,</span>
+ <span
class="n">function_name</span><span class="p">,</span>
+ <span
class="n">current_args</span><span class="p">,</span>
+ <span
class="n">success</span><span class="p">)</span>
+
+
+ <span class="bp">self</span><span class="o">.</span><span
class="n">tar_file_name</span> <span class="o">=</span> <span
class="s">'</span><span class="si">%s</span><span
class="s">/dns_tree_</span><span class="si">%s</span><span
class="s">-</span><span class="si">%s</span><span
class="s">.tar.bz2'</span> <span class="o">%</span> <span
class="p">(</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">current_time</span><span class="o">.</span><span
class="n">strftime</span><span class="p">(</span><span
class="s">"</span><span class="si">%d</span><span
class="s">_%m_%yT%H_%M"</span><span class="p">),</span> <span
class="n">log_id</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">os</span><span
class="o">.</span><span class="n">path</span><span class="o">.</span><span
class="n">exists</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">)</span> <span
class="p">):</span>
+ <span class="n">os</span><span class="o">.</span><span
class="n">makedirs</span><span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">)</span>
+
+ <span class="n">audit_log_replay_dump_file</span> <span
class="o">=</span> <span class="n">bz2</span><span class="o">.</span><span
class="n">BZ2File</span><span class="p">(</span>
+ <span class="s">'</span><span class="si">%s</span><span
class="s">/audit_log_replay_dump-</span><span class="si">%s</span><span
class="s">.bz2'</span> <span class="o">%</span> <span
class="p">(</span><span class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">log_id</span><span class="p">),</span> <span
class="s">'w'</span><span class="p">)</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="k">for</span> <span class="n">audit_index</span><span
class="p">,</span> <span class="n">audit_entry</span> <span
class="ow">in</span> <span class="nb">enumerate</span><span
class="p">(</span><span class="n">audit_log_replay_dump</span><span
class="p">):</span>
+ <span class="n">audit_log_replay_dump</span><span
class="p">[</span><span class="n">audit_index</span><span
class="p">]</span> <span class="o">=</span> <span
class="n">audit_entry</span><span class="o">.</span><span
class="n">encode</span><span class="p">(</span><span
class="s">'utf-8'</span><span class="p">)</span>
+ <span class="n">audit_log_replay_dump_file</span><span
class="o">.</span><span class="n">writelines</span><span
class="p">(</span><span class="n">audit_log_replay_dump</span><span
class="p">)</span>
+ <span class="k">finally</span><span class="p">:</span>
+ <span class="n">audit_log_replay_dump_file</span><span
class="o">.</span><span class="n">close</span><span class="p">()</span>
+
+ <span class="n">full_dump_file</span> <span class="o">=</span> <span
class="n">bz2</span><span class="o">.</span><span
class="n">BZ2File</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">/full_database_dump-</span><span class="si">%s</span><span
class="s">.bz2'</span> <span class="o">%</span>
+ <span class="p">(</span><span
class="bp">self</span><span class="o">.</span><span
class="n">backup_dir</span><span class="p">,</span> <span
class="n">log_id</span><span class="p">),</span> <span
class="s">'w'</span><span class="p">)</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="k">for</span> <span
class="n">full_dump_index</span><span class="p">,</span> <span
class="n">full_dump_entry</span> <span class="ow">in</span> <span
class="nb">enumerate</span><span class="p">(</span><span
class="n">full_database_dump</span><span class="p">):</span>
+ <span class="n">full_database_dump</span><span
class="p">[</span><span class="n">full_dump_index</span><span
class="p">]</span> <span class="o">=</span> <span
class="n">full_dump_entry</span><span class="o">.</span><span
class="n">encode</span><span class="p">(</span><span
class="s">'utf-8'</span><span class="p">)</span>
+ <span class="n">full_dump_file</span><span class="o">.</span><span
class="n">writelines</span><span class="p">(</span><span
class="n">full_database_dump</span><span class="p">)</span>
+ <span class="k">finally</span><span class="p">:</span>
+ <span class="n">full_dump_file</span><span class="o">.</span><span
class="n">close</span><span class="p">()</span>
+
+ <span class="bp">self</span><span class="o">.</span><span
class="n">config_lib_instance</span><span class="o">.</span><span
class="n">TarDnsTree</span><span class="p">(</span><span
class="n">log_id</span><span class="p">)</span>
+</div>
+<div class="viewcode-block" id="BindTreeExport.CookRawDump"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.CookRawDump">[docs]</a>
<span class="k">def</span> <span class="nf">CookRawDump</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">raw_dump</span><span class="p">):</span>
+ <span class="sd">"""This takes raw data from the
database and turns it into a</span>
+<span class="sd"> mysqldump-like output.</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> raw_dump: list of dictionaries that contain all of
the tables</span>
+<span class="sd"> and their associated metadata</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> list: tuple of list of strings to be concatenated
into mysql dump files</span>
+<span class="sd"> """</span>
+ <span class="c"># Stole these lines from mysqldump output, not sure
all are needed</span>
+ <span class="n">header</span> <span class="o">=</span> <span
class="p">[</span><span class="s">'SET
@OLD_CHARACTER_SET_CLIENT=@@CHARACTER_SET_CLIENT;</span><span
class="se">\n</span><span class="s">'</span><span class="p">,</span>
+ <span class="s">'SET
@OLD_CHARACTER_SET_RESULTS=@@CHARACTER_SET_RESULTS;</span><span
class="se">\n</span><span class="s">'</span><span class="p">,</span>
+ <span class="s">'SET
@OLD_COLLATION_CONNECTION=@@COLLATION_CONNECTION;</span><span
class="se">\n</span><span class="s">'</span><span class="p">,</span>
+ <span class="s">'SET NAMES utf8;</span><span
class="se">\n</span><span class="s">'</span>
+ <span class="s">'SET
@OLD_TIME_ZONE=@@TIME_ZONE;</span><span class="se">\n</span><span
class="s">'</span><span class="p">,</span>
+ <span class="s">"SET
TIME_ZONE='+00:00';</span><span class="se">\n</span><span
class="s">"</span><span class="p">,</span>
+ <span class="s">'SET
@OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS;</span><span class="se">\n</span><span
class="s">'</span><span class="p">,</span>
+ <span class="s">'SET UNIQUE_CHECKS=0;</span><span
class="se">\n</span><span class="s">'</span><span class="p">,</span>
+ <span class="s">'SET
@OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS;</span><span
class="se">\n</span><span class="s">'</span><span class="p">,</span>
+ <span class="s">'SET FOREIGN_KEY_CHECKS=0;</span><span
class="se">\n</span><span class="s">'</span><span class="p">,</span>
+ <span class="s">'SET
@OLD_SQL_MODE=@@SQL_MODE;</span><span class="se">\n</span><span
class="s">'</span><span class="p">,</span>
+ <span class="s">"SET
SQL_MODE='NO_AUTO_VALUE_ON_ZERO';</span><span
class="se">\n</span><span class="s">"</span><span class="p">,</span>
+ <span class="s">'SET
@OLD_SQL_NOTES=@@SQL_NOTES;</span><span class="se">\n</span><span
class="s">'</span>
+ <span class="s">'SET SQL_NOTES=0;</span><span
class="se">\n</span><span class="s">'</span><span class="p">]</span>
+
+ <span class="n">footer</span> <span class="o">=</span> <span
class="p">[</span><span class="s">'SET
SQL_MODE=@OLD_SQL_MODE;</span><span class="se">\n</span><span
class="s">'</span><span class="p">,</span>
+ <span class="s">'SET
FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS;</span><span
class="se">\n</span><span class="s">'</span><span class="p">,</span>
+ <span class="s">'SET
UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS;</span><span class="se">\n</span><span
class="s">'</span><span class="p">,</span>
+ <span class="s">'SET
CHARACTER_SET_CLIENT=@OLD_CHARACTER_SET_CLIENT;</span><span
class="se">\n</span><span class="s">'</span><span class="p">,</span>
+ <span class="s">'SET
CHARACTER_SET_RESULTS=@OLD_CHARACTER_SET_RESULTS;</span><span
class="se">\n</span><span class="s">'</span><span class="p">,</span>
+ <span class="s">'SET
COLLATION_CONNECTION=@OLD_COLLATION_CONNECTION;</span><span
class="se">\n</span><span class="s">'</span><span class="p">,</span>
+ <span class="s">'SET
SQL_NOTES=@OLD_SQL_NOTES;</span><span class="se">\n</span><span
class="s">'</span><span class="p">]</span>
+
+ <span class="n">full_database_dump</span> <span class="o">=</span>
<span class="p">[]</span>
+ <span class="n">full_database_dump</span><span class="o">.</span><span
class="n">extend</span><span class="p">(</span><span
class="n">header</span><span class="p">)</span>
+ <span class="n">audit_log_replay_dump</span> <span class="o">=</span>
<span class="p">[]</span>
+ <span class="n">audit_log_replay_dump</span><span
class="o">.</span><span class="n">extend</span><span
class="p">(</span><span class="n">header</span><span class="p">)</span>
+
+ <span class="k">for</span> <span class="n">table_name</span><span
class="p">,</span> <span class="n">table_data</span> <span
class="ow">in</span> <span class="n">raw_dump</span><span
class="o">.</span><span class="n">iteritems</span><span class="p">():</span>
+ <span class="n">table_lines</span> <span class="o">=</span> <span
class="p">[]</span>
+ <span class="n">table_lines</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span class="s">'DROP
TABLE IF EXISTS `</span><span class="si">%s</span><span
class="s">`;</span><span class="se">\n</span><span class="s">'</span>
<span class="o">%</span> <span class="n">table_name</span><span
class="p">)</span>
+ <span class="n">table_lines</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="n">table_data</span><span class="p">[</span><span
class="s">'schema'</span><span class="p">])</span>
+ <span class="n">table_lines</span><span class="p">[</span><span
class="o">-</span><span class="mi">1</span><span class="p">]</span> <span
class="o">=</span> <span class="s">'</span><span
class="si">%s</span><span class="s">;'</span> <span class="o">%</span>
<span class="n">table_lines</span><span class="p">[</span><span
class="o">-</span><span class="mi">1</span><span class="p">]</span>
+ <span class="k">for</span> <span class="n">row</span> <span
class="ow">in</span> <span class="n">table_data</span><span
class="p">[</span><span class="s">'rows'</span><span
class="p">]:</span>
+ <span class="n">insert_row</span> <span class="o">=</span> <span
class="s">"INSERT INTO </span><span class="si">%s</span><span
class="s"> (</span><span class="si">%s</span><span class="s">) VALUES
(</span><span class="si">%%</span><span class="s">(</span><span
class="si">%s</span><span class="s">)s);</span><span
class="se">\n</span><span class="s">"</span> <span class="o">%</span>
<span class="p">(</span>
+ <span class="n">table_name</span><span class="p">,</span>
<span class="s">','</span><span class="o">.</span><span
class="n">join</span><span class="p">(</span><span
class="n">table_data</span><span class="p">[</span><span
class="s">'columns'</span><span class="p">]),</span>
+ <span class="s">")s, %("</span><span
class="o">.</span><span class="n">join</span><span class="p">(</span><span
class="n">table_data</span><span class="p">[</span><span
class="s">'columns'</span><span class="p">]))</span>
+ <span class="n">table_lines</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="n">insert_row</span> <span class="o">%</span> <span
class="n">row</span><span class="p">)</span>
+
+ <span class="n">full_database_dump</span><span
class="o">.</span><span class="n">extend</span><span
class="p">(</span><span class="n">table_lines</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">table_name</span> <span class="ow">not</span> <span
class="ow">in</span> <span class="n">constants</span><span
class="o">.</span><span class="n">TABLES_NOT_AUDIT_LOGGED</span> <span
class="p">):</span>
+ <span class="n">audit_log_replay_dump</span><span
class="o">.</span><span class="n">extend</span><span
class="p">(</span><span class="n">table_lines</span><span class="p">)</span>
+
+ <span class="n">full_database_dump</span><span class="o">.</span><span
class="n">extend</span><span class="p">(</span><span
class="n">footer</span><span class="p">)</span>
+ <span class="n">audit_log_replay_dump</span><span
class="o">.</span><span class="n">extend</span><span
class="p">(</span><span class="n">footer</span><span class="p">)</span>
+
+ <span class="k">return</span> <span class="p">(</span><span
class="n">audit_log_replay_dump</span><span class="p">,</span> <span
class="n">full_database_dump</span><span class="p">)</span>
+</div>
+<div class="viewcode-block"
id="BindTreeExport.ListLatestNamedConfGlobalOptions"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.ListLatestNamedConfGlobalOptions">[docs]</a>
<span class="k">def</span> <span
class="nf">ListLatestNamedConfGlobalOptions</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">data</span><span class="p">,</span> <span
class="n">dns_server_set</span><span class="p">,</span>
+ <span class="n">binary</span><span
class="o">=</span><span class="bp">False</span><span class="p">):</span>
+ <span class="sd">"""Lists latest named.conf global
options</span>
+
+<span class="sd"> This function is duplicated in
roster-core/roster_core/core_helpers.py</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> data: data from GetRawData</span>
+<span class="sd"> dns_server_set: string of dns server set name</span>
+<span class="sd"> binary: True if named.conf file format is binary,
false otherwise</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> string: string of latest named.conf global
options</span>
+<span class="sd"> """</span>
+ <span class="n">current_timestamp</span> <span class="o">=</span>
<span class="n">datetime</span><span class="o">.</span><span
class="n">datetime</span><span class="o">.</span><span
class="n">now</span><span class="p">()</span>
+ <span class="n">smallest_time_differential</span> <span
class="o">=</span> <span class="n">datetime</span><span
class="o">.</span><span class="n">timedelta</span><span
class="p">(</span><span class="n">weeks</span><span class="o">=</span><span
class="mi">100000</span><span class="p">)</span>
+ <span class="n">newest_config</span> <span class="o">=</span> <span
class="bp">None</span>
+ <span class="k">for</span> <span class="n">named_config</span> <span
class="ow">in</span> <span class="n">data</span><span
class="p">[</span><span
class="s">'named_conf_global_options'</span><span
class="p">]:</span>
+ <span class="n">time_differential</span> <span class="o">=</span>
<span class="n">current_timestamp</span> <span class="o">-</span> <span
class="n">named_config</span><span class="p">[</span><span
class="s">'options_created'</span><span class="p">]</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">named_config</span><span class="p">[</span><span
class="s">'named_conf_global_options_dns_server_set_name'</span><span
class="p">]</span> <span class="o">==</span> <span class="p">(</span>
+ <span class="n">dns_server_set</span><span class="p">)</span>
<span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">time_differential</span> <span class="o"><</span> <span
class="n">smallest_time_differential</span> <span class="p">):</span>
+ <span class="n">smallest_time_differential</span> <span
class="o">=</span> <span class="n">time_differential</span>
+ <span class="n">newest_config</span> <span class="o">=</span>
<span class="n">named_config</span><span class="p">[</span><span
class="s">'global_options'</span><span class="p">]</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">newest_config</span> <span class="ow">is</span> <span
class="ow">not</span> <span class="bp">None</span> <span class="p">):</span>
+ <span class="n">deserialized_config</span> <span class="o">=</span>
<span class="n">iscpy</span><span class="o">.</span><span
class="n">Deserialize</span><span class="p">(</span><span
class="n">newest_config</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">binary</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="nb">len</span><span class="p">(</span><span
class="n">deserialized_config</span><span class="p">)</span> <span
class="o">==</span> <span class="mi">0</span> <span class="p">):</span>
+ <span class="k">return</span> <span class="p">(</span><span
class="s">u'options {</span><span class="se">\n</span><span
class="s">'</span>
+ <span class="s">u'masterfile-format raw;</span><span
class="se">\n</span><span class="s">'</span>
+ <span class="s">u'};'</span><span
class="p">)</span>
+ <span class="n">deserialized_part</span> <span class="o">=</span>
<span class="n">deserialized_config</span><span class="o">.</span><span
class="n">partition</span><span class="p">(</span><span
class="s">'options {'</span><span class="p">)</span>
+ <span class="n">new_options</span> <span class="o">=</span> <span
class="s">'</span><span class="se">\n</span><span
class="s">masterfile-format raw; '</span>
+ <span class="n">deserialized_config</span> <span
class="o">=</span> <span class="s">'</span><span
class="si">%s%s%s%s</span><span class="s">'</span> <span
class="o">%</span> <span class="p">(</span>
+ <span class="n">deserialized_part</span><span
class="p">[</span><span class="mi">0</span><span class="p">],</span>
+ <span class="n">deserialized_part</span><span
class="p">[</span><span class="mi">1</span><span class="p">],</span>
+ <span class="n">new_options</span><span class="p">,</span>
+ <span class="n">deserialized_part</span><span
class="p">[</span><span class="mi">2</span><span class="p">])</span>
+ <span class="k">return</span> <span
class="n">deserialized_config</span>
+ <span class="k">return</span> <span class="n">newest_config</span>
+</div>
+<div class="viewcode-block" id="BindTreeExport.MakeNamedConf"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.MakeNamedConf">[docs]</a>
<span class="k">def</span> <span class="nf">MakeNamedConf</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">data</span><span class="p">,</span> <span
class="n">cooked_data</span><span class="p">,</span> <span
class="n">dns_server_set</span><span class="p">,</span> <span
class="n">extension</span><span class="p">,</span>
+ <span class="n">remote_bind_dir</span><span
class="p">,</span> <span class="n">binary</span><span
class="o">=</span><span class="bp">False</span><span class="p">):</span>
+ <span class="sd">"""Makes named.conf file strings</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> data: data from GetRawData</span>
+<span class="sd"> cooked_data: data from cooked_data</span>
+<span class="sd"> dns_server_set: string of dns_server_set</span>
+<span class="sd"> extension: bind extension, e.g., .db, .aa (binary),
etc</span>
+<span class="sd"> remote_bind_dir: string of remote server bind
dir</span>
+<span class="sd"> binary: True if named.conf file format is binary,
false otherwise</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> string: string of named.conf file</span>
+<span class="sd"> """</span>
+ <span class="n">acl_dict</span> <span class="o">=</span> <span
class="p">{}</span>
+ <span class="n">named_conf_lines</span> <span class="o">=</span> <span
class="p">[</span><span class="s">'#This named.conf file is
autogenerated. DO NOT EDIT'</span><span class="p">]</span>
+ <span class="n">named_conf_header</span> <span class="o">=</span>
<span class="bp">self</span><span class="o">.</span><span
class="n">ListLatestNamedConfGlobalOptions</span><span class="p">(</span>
+ <span class="n">data</span><span class="p">,</span> <span
class="n">dns_server_set</span><span class="p">,</span> <span
class="n">binary</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">named_conf_header</span> <span class="ow">is</span> <span
class="bp">None</span> <span class="p">):</span>
+ <span class="k">raise</span> <span class="n">Error</span><span
class="p">(</span><span class="s">'Named conf global options missing
for server set "</span><span class="si">%s</span><span
class="s">"'</span> <span class="o">%</span> <span
class="p">(</span>
+ <span class="n">dns_server_set</span><span class="p">))</span>
+ <span class="n">named_conf_header</span> <span class="o">=</span>
<span class="bp">self</span><span class="o">.</span><span
class="n">NamedHeaderChangeDirectory</span><span class="p">(</span>
+ <span class="n">named_conf_header</span><span class="p">,</span>
<span class="s">'</span><span class="si">%s</span><span
class="s">/named'</span> <span class="o">%</span> <span
class="n">remote_bind_dir</span><span class="o">.</span><span
class="n">rstrip</span><span class="p">(</span><span
class="s">'/'</span><span class="p">))</span>
+ <span class="n">named_conf_lines</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="n">named_conf_header</span><span class="p">)</span>
+ <span class="k">for</span> <span class="n">acl_range</span> <span
class="ow">in</span> <span class="n">data</span><span
class="p">[</span><span class="s">'acl_ranges'</span><span
class="p">]:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">acl_range</span><span
class="p">[</span><span class="s">'acl_ranges_acl_name'</span><span
class="p">]</span> <span class="ow">in</span> <span
class="n">acl_dict</span> <span class="p">):</span>
+ <span class="n">acl_dict</span><span class="p">[</span><span
class="n">acl_range</span><span class="p">[</span><span
class="s">'acl_ranges_acl_name'</span><span class="p">]]</span>
<span class="o">=</span> <span class="p">{}</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">acl_range</span><span class="p">[</span><span
class="s">'acl_range_cidr_block'</span><span class="p">]</span>
<span class="ow">is</span> <span class="bp">None</span> <span
class="p">):</span>
+ <span class="n">acl_dict</span><span class="p">[</span><span
class="n">acl_range</span><span class="p">[</span><span
class="s">'acl_range_cidr_block'</span><span class="p">]]</span>
<span class="o">=</span> <span class="bp">None</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">acl_range</span><span
class="p">[</span><span
class="s">'acl_range_cidr_block'</span><span class="p">]</span>
<span class="ow">in</span>
+ <span class="n">acl_dict</span><span class="p">[</span><span
class="n">acl_range</span><span class="p">[</span><span
class="s">'acl_ranges_acl_name'</span><span class="p">]]</span>
<span class="p">):</span>
+ <span class="n">acl_dict</span><span class="p">[</span>
+ <span class="n">acl_range</span><span
class="p">[</span><span class="s">'acl_ranges_acl_name'</span><span
class="p">]][</span><span class="n">acl_range</span><span class="p">[</span>
+ <span
class="s">'acl_range_cidr_block'</span><span class="p">]]</span>
<span class="o">=</span> <span class="p">{}</span>
+
+ <span class="k">for</span> <span class="n">acl</span> <span
class="ow">in</span> <span class="n">acl_dict</span><span class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">acl_dict</span><span class="p">[</span><span
class="n">acl</span><span class="p">]</span> <span class="ow">is</span>
<span class="ow">not</span> <span class="bp">None</span> <span
class="ow">and</span> <span class="n">acl</span> <span class="o">!=</span>
<span class="s">'any'</span> <span class="p">):</span>
+ <span class="n">named_conf_lines</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="s">'acl </span><span
class="si">%s</span><span class="s"> {'</span> <span class="o">%</span>
<span class="n">acl</span><span class="p">)</span>
+ <span class="k">for</span> <span class="n">cidr</span> <span
class="ow">in</span> <span class="n">acl_dict</span><span
class="p">[</span><span class="n">acl</span><span class="p">]:</span>
+ <span class="n">named_conf_lines</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="s">'</span><span
class="se">\t</span><span class="si">%s</span><span class="s">;'</span>
<span class="o">%</span> <span class="n">cidr</span><span class="p">)</span>
+ <span class="n">named_conf_lines</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="s">'};</span><span
class="se">\n</span><span class="s">'</span><span class="p">)</span>
+
+ <span class="n">view_orders</span> <span class="o">=</span> <span
class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set</span><span class="p">][</span>
+ <span class="s">'view_order'</span><span
class="p">]</span><span class="o">.</span><span class="n">keys</span><span
class="p">()</span>
+ <span class="n">view_orders</span><span class="o">.</span><span
class="n">sort</span><span class="p">()</span>
+ <span class="k">for</span> <span class="n">view_order</span> <span
class="ow">in</span> <span class="n">view_orders</span><span
class="p">:</span>
+ <span class="n">view_name</span> <span class="o">=</span> <span
class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set</span><span class="p">][</span>
+ <span class="s">'view_order'</span><span
class="p">][</span><span class="n">view_order</span><span class="p">]</span>
+
+ <span class="n">named_conf_lines</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span class="s">'view
"</span><span class="si">%s</span><span class="s">" {'</span>
<span class="o">%</span> <span class="n">view_name</span><span
class="p">)</span>
+ <span class="n">clients</span> <span class="o">=</span> <span
class="p">[]</span>
+ <span class="n">found_acl</span> <span class="o">=</span> <span
class="bp">False</span>
+ <span class="k">for</span> <span class="n">acl_name</span> <span
class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span>
+ <span class="n">view_name</span><span class="p">][</span><span
class="s">'acls'</span><span class="p">]:</span>
+ <span class="k">for</span> <span
class="n">view_acl_assignment</span> <span class="ow">in</span> <span
class="n">data</span><span class="p">[</span><span
class="s">'view_acl_assignments'</span><span class="p">]:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">view_acl_assignment</span><span class="p">[</span><span
class="s">'view_acl_assignments_view_name'</span><span
class="p">]</span> <span class="o">==</span>
+ <span class="n">view_name</span> <span class="ow">and</span>
+ <span class="n">view_acl_assignment</span><span
class="p">[</span><span
class="s">'view_acl_assignments_dns_server_set_name'</span><span
class="p">]</span> <span class="o">==</span>
+ <span class="n">dns_server_set</span> <span
class="ow">and</span>
+ <span class="n">view_acl_assignment</span><span
class="p">[</span><span
class="s">'view_acl_assignments_acl_name'</span><span
class="p">]</span> <span class="o">==</span>
+ <span class="n">acl_name</span> <span class="p">):</span>
+ <span class="n">found_acl</span> <span class="o">=</span>
<span class="bp">True</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">view_acl_assignment</span><span class="p">[</span><span
class="s">'view_acl_assignments_range_allowed'</span><span
class="p">]</span> <span class="o">==</span>
+ <span class="bp">True</span> <span class="p">):</span>
+ <span class="n">clients</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="s">'</span><span class="si">%s</span><span
class="s">;'</span> <span class="o">%</span> <span
class="n">acl_name</span><span class="p">)</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">clients</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="s">'!</span><span class="si">%s</span><span
class="s">;'</span> <span class="o">%</span> <span
class="n">acl_name</span><span class="p">)</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="n">clients</span> <span class="o">==</span> <span
class="p">[]</span> <span class="ow">and</span> <span
class="n">found_acl</span> <span class="p">):</span>
+ <span class="n">clients</span> <span class="o">=</span> <span
class="p">[</span><span class="s">u'any;'</span><span
class="p">]</span>
+
+ <span class="c"># sort the acls with the negatives first</span>
+ <span class="n">sorted_clients</span> <span class="o">=</span> <span
class="p">[]</span>
+ <span class="k">for</span> <span class="n">client</span> <span
class="ow">in</span> <span class="n">clients</span><span class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">client</span><span class="o">.</span><span
class="n">startswith</span><span class="p">(</span><span
class="s">'!'</span><span class="p">)</span> <span
class="p">):</span>
+ <span class="n">sorted_clients</span><span
class="o">.</span><span class="n">insert</span><span
class="p">(</span><span class="mi">0</span><span class="p">,</span> <span
class="n">client</span><span class="p">)</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">sorted_clients</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="n">client</span><span class="p">)</span>
+
+ <span class="n">named_conf_lines</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="s">'</span><span class="se">\t</span><span
class="s">match-clients { </span><span class="se">\n\t\t</span><span
class="si">%s</span><span class="se">\n\t</span><span class="s">
};'</span> <span class="o">%</span> <span class="p">(</span>
+ <span class="s">'</span><span class="se">\n\t\t</span><span
class="s">'</span><span class="o">.</span><span
class="n">join</span><span class="p">(</span><span
class="n">sorted_clients</span><span class="p">)))</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set</span><span class="p">][</span><span
class="s">'views'</span><span class="p">][</span><span
class="n">view_name</span><span class="p">][</span>
+ <span class="s">'view_options'</span><span
class="p">]</span> <span class="p">):</span>
+ <span class="n">named_conf_lines</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="s">'</span><span
class="se">\t</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span>
+ <span class="n">dns_server_set</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span><span class="n">view_name</span><span
class="p">][</span><span class="s">'view_options'</span><span
class="p">])</span>
+
+ <span class="c"># add root hint file</span>
+ <span class="n">named_conf_lines</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="s">'</span><span class="se">\t</span><span class="s">zone
"." {'</span><span class="p">)</span>
+ <span class="n">named_conf_lines</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="s">'</span><span class="se">\t\t</span><span class="s">type
hint;'</span><span class="p">)</span>
+ <span class="n">named_conf_lines</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="s">'</span><span class="se">\t\t</span><span class="s">file
"
named.ca";'</span><span class="p">)</span>
+ <span class="n">named_conf_lines</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="s">'</span><span class="se">\t</span><span
class="s">};'</span><span class="p">)</span>
+
+ <span class="k">for</span> <span class="n">zone</span> <span
class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span>
+ <span class="n">view_name</span><span class="p">][</span><span
class="s">'zones'</span><span class="p">]:</span>
+ <span class="n">records</span> <span class="o">=</span> <span
class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set</span><span class="p">][</span><span
class="s">'views'</span><span class="p">][</span>
+ <span class="n">view_name</span><span class="p">][</span><span
class="s">'zones'</span><span class="p">][</span><span
class="n">zone</span><span class="p">][</span><span
class="s">'records'</span><span class="p">]</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set</span><span class="p">][</span><span
class="s">'views'</span><span class="p">][</span>
+ <span class="n">view_name</span><span class="p">][</span><span
class="s">'zones'</span><span class="p">][</span><span
class="n">zone</span><span class="p">][</span><span
class="s">'zone_type'</span><span class="p">]</span> <span
class="o">!=</span> <span class="s">'slave'</span> <span
class="p">):</span>
+ <span class="c">#If there is no SOA record for this zone, a zone
file won't be generated</span>
+ <span class="c">#so we don't put a reference to a
non-existent file in named.conf</span>
+ <span class="k">for</span> <span class="n">record</span> <span
class="ow">in</span> <span class="n">records</span><span class="p">:</span>
+ <span class="k">if</span> <span class="n">record</span><span
class="p">[</span><span class="s">'record_type'</span><span
class="p">]</span> <span class="o">==</span> <span
class="s">u'soa'</span><span class="p">:</span>
+ <span class="k">break</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">continue</span>
+
+ <span class="n">named_conf_lines</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="s">'</span><span
class="se">\t</span><span class="s">zone "</span><span
class="si">%s</span><span class="s">" {'</span> <span
class="o">%</span> <span class="p">(</span>
+ <span class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set</span><span class="p">][</span><span
class="s">'views'</span><span class="p">][</span><span
class="n">view_name</span><span class="p">][</span>
+ <span class="s">'zones'</span><span
class="p">][</span><span class="n">zone</span><span
class="p">][</span><span class="s">'zone_origin'</span><span
class="p">]</span><span class="o">.</span><span
class="n">rstrip</span><span class="p">(</span><span
class="s">'.'</span><span class="p">)))</span>
+ <span class="n">named_conf_lines</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="s">'</span><span
class="se">\t\t</span><span class="s">type </span><span
class="si">%s</span><span class="s">;'</span> <span class="o">%</span>
<span class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span>
+ <span class="n">dns_server_set</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span><span class="n">view_name</span><span
class="p">][</span><span class="s">'zones'</span><span
class="p">][</span><span class="n">zone</span><span
class="p">][</span><span class="s">'zone_type'</span><span
class="p">])</span>
+ <span class="n">named_conf_lines</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="s">'</span><span
class="se">\t\t</span><span class="s">file "</span><span
class="si">%s</span><span class="s">/</span><span class="si">%s</span><span
class="s">.</span><span class="si">%s</span><span
class="s">";'</span> <span class="o">%</span> <span
class="p">(</span>
+ <span class="n">view_name</span><span class="p">,</span> <span
class="n">zone</span><span class="p">,</span> <span
class="n">extension</span><span class="p">))</span>
+ <span class="n">zone_options</span> <span class="o">=</span> <span
class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set</span><span class="p">][</span><span
class="s">'views'</span><span class="p">][</span>
+ <span class="n">view_name</span><span class="p">][</span><span
class="s">'zones'</span><span class="p">][</span><span
class="n">zone</span><span class="p">][</span><span
class="s">'zone_options'</span><span class="p">]</span><span
class="o">.</span><span class="n">replace</span><span
class="p">(</span><span class="s">'</span><span
class="se">\n</span><span class="s">'</span><span class="p">,</span>
<span class="s">'</span><span class="se">\n\t\t</span><span
class="s">'</span><span class="p">)</span>
+ <span class="n">named_conf_lines</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="s">'</span><span
class="se">\t\t</span><span class="si">%s</span><span
class="s">'</span> <span class="o">%</span> <span
class="n">zone_options</span><span class="p">)</span>
+ <span class="n">named_conf_lines</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="s">'</span><span
class="se">\t</span><span class="s">};'</span><span class="p">)</span>
+ <span class="n">named_conf_lines</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="s">'};'</span><span class="p">)</span>
+ <span class="k">return</span> <span class="s">'</span><span
class="se">\n</span><span class="s">'</span><span
class="o">.</span><span class="n">join</span><span class="p">(</span><span
class="n">named_conf_lines</span><span class="p">)</span>
+</div>
+<div class="viewcode-block" id="BindTreeExport.ListACLNamesByView"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.ListACLNamesByView">[docs]</a>
<span class="k">def</span> <span class="nf">ListACLNamesByView</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">data</span><span class="p">,</span> <span
class="n">view</span><span class="p">):</span>
+ <span class="sd">"""Lists acl names</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> data: data from GetRawData</span>
+<span class="sd"> view: string of view name</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> list: list of acl names ex:</span>
+<span class="sd"> ['private', 'public']</span>
+<span class="sd"> """</span>
+ <span class="n">acl_list</span> <span class="o">=</span> <span
class="p">[]</span>
+ <span class="k">for</span> <span class="n">view_acl_assignment</span>
<span class="ow">in</span> <span class="n">data</span><span
class="p">[</span><span
class="s">'view_acl_assignments'</span><span class="p">]:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">view_acl_assignment</span><span class="p">[</span><span
class="s">'view_acl_assignments_view_name'</span><span
class="p">]</span> <span class="o">==</span> <span class="n">view</span>
<span class="ow">and</span>
+ <span class="n">view_acl_assignment</span><span
class="p">[</span><span
class="s">'view_acl_assignments_acl_name'</span><span
class="p">]</span> <span class="ow">not</span> <span class="ow">in</span>
+ <span class="n">acl_list</span> <span class="p">):</span>
+ <span class="n">acl_list</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="n">view_acl_assignment</span><span class="p">[</span><span
class="s">'view_acl_assignments_acl_name'</span><span
class="p">])</span>
+ <span class="k">return</span> <span class="n">acl_list</span>
+</div>
+<div class="viewcode-block" id="BindTreeExport.GetRawData"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.GetRawData">[docs]</a>
<span class="k">def</span> <span class="nf">GetRawData</span><span
class="p">(</span><span class="bp">self</span><span class="p">):</span>
+ <span class="sd">"""Gets raw data from database</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> tuple of two dictionaries:</span>
+<span class="sd"> dictionary of raw data keyed by data name with
values of dicts</span>
+<span class="sd"> containing values of that type's
attributes</span>
+<span class="sd"> dictionary of the raw dump keyed by data name
with values of</span>
+<span class="sd"> dicts containing the db dump keyed by row,
column, and schema</span>
+<span class="sd"> example:</span>
+<span class="sd"> ({'view_acl_assignments': ({</span>
+<span class="sd"> 'view_acl_assignments_view_name':
u'external',</span>
+<span class="sd">
'view_acl_assignments_dns_server_set_name':
u'external_dns',</span>
+<span class="sd"> 'view_acl_assignments_acl_name':
u'public',</span>
+<span class="sd">
'view_acl_assignments_acl_range_allowed': 1})},</span>
+<span class="sd"> { u'zones':</span>
+<span class="sd"> {'rows':[{}],</span>
+<span class="sd"> 'columns': [u'zones_id',
u'zone_name'],</span>
+<span class="sd"> 'schema':(</span>
+<span class="sd"> u'CREATE TABLE `zones` (\n `zones_id`
mediumint(8) ',</span>
+<span class="sd"> 'unsigned NOT NULL auto_increment,\n
`zone_name` varchar(255) ',</span>
+<span class="sd"> 'NOT NULL,\n PRIMARY KEY
(`zones_id`),\n UNIQUE KEY ;</span>
+<span class="sd"> '`zone_name` (`zone_name`),\n KEY
`zone_name_1` '</span>
+<span class="sd"> '(`zone_name`)\n) ENGINE=InnoDB
AUTO_INCREMENT=9 DEFAULT ',</span>
+<span class="sd"> 'CHARSET=utf8')}}),</span>
+<span class="sd"> """</span>
+ <span class="n">data</span> <span class="o">=</span> <span
class="p">{}</span>
+ <span class="n">named_conf_global_options_dict</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">GetEmptyRowDict</span><span
class="p">(</span>
+ <span class="s">'named_conf_global_options'</span><span
class="p">)</span>
+ <span class="n">data</span><span class="p">[</span><span
class="s">'named_conf_global_options'</span><span
class="p">]</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">ListRow</span><span class="p">(</span>
+ <span class="s">'named_conf_global_options'</span><span
class="p">,</span> <span
class="n">named_conf_global_options_dict</span><span class="p">)</span>
+
+ <span class="n">dns_server_set_view_assignments_dict</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">GetEmptyRowDict</span><span
class="p">(</span>
+ <span
class="s">'dns_server_set_view_assignments'</span><span
class="p">)</span>
+ <span class="n">data</span><span class="p">[</span><span
class="s">'dns_server_set_view_assignments'</span><span
class="p">]</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">ListRow</span><span class="p">(</span>
+ <span
class="s">'dns_server_set_view_assignments'</span><span
class="p">,</span> <span
class="n">dns_server_set_view_assignments_dict</span><span
class="p">)</span>
+
+ <span class="n">dns_server_set_assignments_dict</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">GetEmptyRowDict</span><span
class="p">(</span>
+ <span class="s">'dns_server_set_assignments'</span><span
class="p">)</span>
+ <span class="n">data</span><span class="p">[</span><span
class="s">'dns_server_set_assignments'</span><span
class="p">]</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">ListRow</span><span class="p">(</span>
+ <span class="s">'dns_server_set_assignments'</span><span
class="p">,</span> <span
class="n">dns_server_set_assignments_dict</span><span class="p">)</span>
+
+ <span class="n">dns_server_set_dict</span> <span class="o">=</span>
<span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">GetEmptyRowDict</span><span class="p">(</span><span
class="s">'dns_server_sets'</span><span class="p">)</span>
+ <span class="n">data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">]</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">ListRow</span><span
class="p">(</span><span class="s">'dns_server_sets'</span><span
class="p">,</span>
+ <span
class="n">dns_server_set_dict</span><span class="p">)</span>
+
+ <span class="n">dns_servers_dict</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">GetEmptyRowDict</span><span class="p">(</span><span
class="s">'dns_servers'</span><span class="p">)</span>
+ <span class="n">data</span><span class="p">[</span><span
class="s">'dns_servers'</span><span class="p">]</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">ListRow</span><span
class="p">(</span><span class="s">'dns_servers'</span><span
class="p">,</span>
+ <span
class="n">dns_servers_dict</span><span class="p">)</span>
+
+ <span class="n">view_dependency_assignments_dict</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">GetEmptyRowDict</span><span
class="p">(</span>
+ <span class="s">'view_dependency_assignments'</span><span
class="p">)</span>
+ <span class="n">data</span><span class="p">[</span><span
class="s">'view_dependency_assignments'</span><span
class="p">]</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">ListRow</span><span class="p">(</span>
+ <span class="s">'view_dependency_assignments'</span><span
class="p">,</span> <span
class="n">view_dependency_assignments_dict</span><span class="p">)</span>
+
+ <span class="n">views_dict</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">GetEmptyRowDict</span><span class="p">(</span><span
class="s">'views'</span><span class="p">)</span>
+ <span class="n">data</span><span class="p">[</span><span
class="s">'views'</span><span class="p">]</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">ListRow</span><span
class="p">(</span><span class="s">'views'</span><span
class="p">,</span> <span class="n">views_dict</span><span class="p">)</span>
+
+ <span class="n">view_acl_assignments_dict</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">GetEmptyRowDict</span><span
class="p">(</span>
+ <span class="s">'view_acl_assignments'</span><span
class="p">)</span>
+ <span class="n">data</span><span class="p">[</span><span
class="s">'view_acl_assignments'</span><span class="p">]</span>
<span class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">ListRow</span><span class="p">(</span>
+ <span class="s">'view_acl_assignments'</span><span
class="p">,</span> <span class="n">view_acl_assignments_dict</span><span
class="p">)</span>
+
+ <span class="n">acl_ranges_dict</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">GetEmptyRowDict</span><span class="p">(</span><span
class="s">'acl_ranges'</span><span class="p">)</span>
+ <span class="n">data</span><span class="p">[</span><span
class="s">'acl_ranges'</span><span class="p">]</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">ListRow</span><span
class="p">(</span><span class="s">'acl_ranges'</span><span
class="p">,</span> <span class="n">acl_ranges_dict</span><span
class="p">)</span>
+
+ <span class="n">record_arguments_records_assignments_dict</span> <span
class="o">=</span> <span class="p">(</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">GetEmptyRowDict</span><span class="p">(</span>
+ <span
class="s">'record_arguments_records_assignments'</span><span
class="p">))</span>
+ <span class="n">data</span><span class="p">[</span><span
class="s">'record_arguments_records_assignments'</span><span
class="p">]</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">ListRow</span><span class="p">(</span>
+ <span
class="s">'record_arguments_records_assignments'</span><span
class="p">,</span>
+ <span
class="n">record_arguments_records_assignments_dict</span><span
class="p">)</span>
+
+ <span class="n">records_dict</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">GetEmptyRowDict</span><span class="p">(</span><span
class="s">'records'</span><span class="p">)</span>
+ <span class="n">data</span><span class="p">[</span><span
class="s">'records'</span><span class="p">]</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">ListRow</span><span class="p">(</span>
+ <span class="s">'records'</span><span class="p">,</span>
<span class="n">records_dict</span><span class="p">,</span> <span
class="s">'record_arguments_records_assignments'</span><span
class="p">,</span>
+ <span
class="n">record_arguments_records_assignments_dict</span><span
class="p">)</span>
+
+ <span class="n">zone_view_assignments_dict</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">GetEmptyRowDict</span><span
class="p">(</span>
+ <span class="s">'zone_view_assignments'</span><span
class="p">)</span>
+ <span class="n">data</span><span class="p">[</span><span
class="s">'zone_view_assignments'</span><span class="p">]</span>
<span class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">ListRow</span><span class="p">(</span>
+ <span class="s">'zone_view_assignments'</span><span
class="p">,</span> <span class="n">zone_view_assignments_dict</span><span
class="p">)</span>
+
+ <span class="n">record_arguments_dict</span> <span class="o">=</span>
<span class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">GetEmptyRowDict</span><span class="p">(</span><span
class="s">'record_arguments'</span><span class="p">)</span>
+ <span class="n">data</span><span class="p">[</span><span
class="s">'record_arguments'</span><span class="p">]</span> <span
class="o">=</span> <span class="bp">self</span><span
class="o">.</span><span class="n">db_instance</span><span
class="o">.</span><span class="n">ListRow</span><span
class="p">(</span><span class="s">'record_arguments'</span><span
class="p">,</span>
+ <span
class="n">record_arguments_dict</span><span class="p">)</span>
+ <span class="n">raw_dump</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">db_instance</span><span class="o">.</span><span
class="n">DumpDatabase</span><span class="p">()</span>
+
+ <span class="k">return</span> <span class="p">(</span><span
class="n">data</span><span class="p">,</span> <span
class="n">raw_dump</span><span class="p">)</span>
+</div>
+<div class="viewcode-block" id="BindTreeExport.SortRecords"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.SortRecords">[docs]</a>
<span class="k">def</span> <span class="nf">SortRecords</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">records</span><span class="p">):</span>
+ <span class="sd">"""Sorts records for zone
exporter</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> records: list of records</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> dict: dictionary keyed by tuple (zone,
view_dep)</span>
+<span class="sd"> ex:</span>
+<span class="sd"> {(u'
university.edu',
u'internal_dep'):</span>
+<span class="sd"> {11: {'target': u'computer4',
'ttl': 3600, 'record_type': u'a',</span>
+<span class="sd"> 'view_name': u'internal',
'last_user': u'sharrell',</span>
+<span class="sd"> 'zone_name':
u'
university.edu',</span>
+<span class="sd"> u'assignment_ip':
u'192.168.1.4'},</span>
+<span class="sd"> 12: {u'serial_number': 20091225,
u'refresh_seconds': 5,</span>
+<span class="sd"> 'target':
u'university.edu.',</span>
+<span class="sd"> u'name_server':
u'ns1.university.edu.', u'retry_seconds': 5,</span>
+<span class="sd"> 'ttl': 3600,
u'minimum_seconds': 5, 'record_type': u'soa',</span>
+<span class="sd"> 'view_name': u'internal',
'last_user': u'sharrell',</span>
+<span class="sd"> 'zone_name':
u'
university.edu',</span>
+<span class="sd"> u'admin_email':
u'ad...@university.edu.',</span>
+<span class="sd"> u'expiry_seconds': 5}}}</span>
+<span class="sd"> """</span>
+ <span class="n">sorted_records</span> <span class="o">=</span> <span
class="p">{}</span>
+ <span class="k">for</span> <span class="n">record</span> <span
class="ow">in</span> <span class="n">records</span><span class="p">:</span>
+ <span class="n">zone_name</span> <span class="o">=</span> <span
class="n">record</span><span class="p">[</span><span
class="s">'record_zone_name'</span><span class="p">]</span>
+ <span class="n">view_dep</span> <span class="o">=</span> <span
class="n">record</span><span class="p">[</span><span
class="s">'record_view_dependency'</span><span class="p">]</span>
+ <span class="n">record_id</span> <span class="o">=</span> <span
class="n">record</span><span class="p">[</span><span
class="s">'record_arguments_records_assignments_record_id'</span><span
class="p">]</span>
+ <span class="n">arg_name</span> <span class="o">=</span> <span
class="n">record</span><span class="p">[</span>
+ <span
class="s">'record_arguments_records_assignments_argument_name'</span><span
class="p">]</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">sorted_records</span><span
class="o">.</span><span class="n">has_key</span><span
class="p">((</span><span class="n">zone_name</span><span class="p">,</span>
<span class="n">view_dep</span><span class="p">))</span> <span
class="p">):</span>
+ <span class="n">sorted_records</span><span
class="p">[(</span><span class="n">zone_name</span><span class="p">,</span>
<span class="n">view_dep</span><span class="p">)]</span> <span
class="o">=</span> <span class="p">{}</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">sorted_records</span><span
class="p">[(</span><span class="n">zone_name</span><span class="p">,</span>
<span class="n">view_dep</span><span class="p">)]</span><span
class="o">.</span><span class="n">has_key</span><span
class="p">(</span><span class="n">record_id</span><span class="p">)</span>
<span class="p">):</span>
+ <span class="n">sorted_records</span><span
class="p">[(</span><span class="n">zone_name</span><span class="p">,</span>
<span class="n">view_dep</span><span class="p">)][</span><span
class="n">record_id</span><span class="p">]</span> <span class="o">=</span>
<span class="p">{}</span>
+
+ <span class="n">sorted_records</span><span
class="p">[(</span><span class="n">zone_name</span><span class="p">,</span>
<span class="n">view_dep</span><span class="p">)][</span><span
class="n">record_id</span><span class="p">][</span><span
class="s">'record_type'</span><span class="p">]</span> <span
class="o">=</span> <span class="p">(</span>
+ <span class="n">record</span><span class="p">[</span><span
class="s">'record_type'</span><span class="p">])</span>
+
+ <span class="n">sorted_records</span><span
class="p">[(</span><span class="n">zone_name</span><span class="p">,</span>
<span class="n">view_dep</span><span class="p">)][</span><span
class="n">record_id</span><span class="p">][</span><span
class="s">'zone_name'</span><span class="p">]</span> <span
class="o">=</span> <span class="p">(</span>
+ <span class="n">record</span><span class="p">[</span><span
class="s">'record_zone_name'</span><span class="p">])</span>
+
+ <span class="n">sorted_records</span><span
class="p">[(</span><span class="n">zone_name</span><span class="p">,</span>
<span class="n">view_dep</span><span class="p">)][</span><span
class="n">record_id</span><span class="p">][</span><span
class="s">'view_name'</span><span class="p">]</span> <span
class="o">=</span> <span class="p">(</span>
+ <span class="n">record</span><span class="p">[</span><span
class="s">'record_view_dependency'</span><span
class="p">]</span><span class="o">.</span><span
class="n">rsplit</span><span class="p">(</span><span
class="s">'_dep'</span><span class="p">,</span> <span
class="mi">1</span><span class="p">)[</span><span class="mi">0</span><span
class="p">])</span>
+
+ <span class="n">sorted_records</span><span
class="p">[(</span><span class="n">zone_name</span><span class="p">,</span>
<span class="n">view_dep</span><span class="p">)][</span><span
class="n">record_id</span><span class="p">][</span><span
class="s">'target'</span><span class="p">]</span> <span
class="o">=</span> <span class="p">(</span>
+ <span class="n">record</span><span class="p">[</span><span
class="s">'record_target'</span><span class="p">])</span>
+
+ <span class="n">sorted_records</span><span
class="p">[(</span><span class="n">zone_name</span><span class="p">,</span>
<span class="n">view_dep</span><span class="p">)][</span><span
class="n">record_id</span><span class="p">][</span><span
class="s">'ttl'</span><span class="p">]</span> <span
class="o">=</span> <span class="p">(</span>
+ <span class="n">record</span><span class="p">[</span><span
class="s">'record_ttl'</span><span class="p">])</span>
+
+ <span class="n">sorted_records</span><span
class="p">[(</span><span class="n">zone_name</span><span class="p">,</span>
<span class="n">view_dep</span><span class="p">)][</span><span
class="n">record_id</span><span class="p">][</span><span
class="s">'last_user'</span><span class="p">]</span> <span
class="o">=</span> <span class="p">(</span>
+ <span class="n">record</span><span class="p">[</span><span
class="s">'record_last_user'</span><span class="p">])</span>
+
+ <span class="n">sorted_records</span><span class="p">[(</span><span
class="n">zone_name</span><span class="p">,</span> <span
class="n">view_dep</span><span class="p">)][</span><span
class="n">record_id</span><span class="p">][</span><span
class="n">arg_name</span><span class="p">]</span> <span class="o">=</span>
<span class="n">record</span><span class="p">[</span>
+ <span class="s">'argument_value'</span><span
class="p">]</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="n">sorted_records</span><span class="p">[(</span><span
class="n">zone_name</span><span class="p">,</span> <span
class="n">view_dep</span><span class="p">)][</span><span
class="n">record_id</span><span class="p">][</span>
+ <span class="n">arg_name</span><span class="p">]</span><span
class="o">.</span><span class="n">isdigit</span><span class="p">()</span>
<span class="p">):</span>
+ <span class="n">sorted_records</span><span
class="p">[(</span><span class="n">zone_name</span><span class="p">,</span>
<span class="n">view_dep</span><span class="p">)][</span><span
class="n">record_id</span><span class="p">][</span><span
class="n">arg_name</span><span class="p">]</span> <span class="o">=</span>
<span class="nb">int</span><span class="p">(</span>
+ <span class="n">sorted_records</span><span
class="p">[(</span><span class="n">zone_name</span><span class="p">,</span>
<span class="n">view_dep</span><span class="p">)][</span><span
class="n">record_id</span><span class="p">][</span><span
class="n">arg_name</span><span class="p">])</span>
+
+ <span class="k">return</span> <span class="n">sorted_records</span>
+</div>
+<div class="viewcode-block" id="BindTreeExport.CookData"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.CookData">[docs]</a>
<span class="k">def</span> <span class="nf">CookData</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">data</span><span class="p">):</span>
+ <span class="sd">"""Cooks data for zone exporter</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> data: dictionary of raw data from database</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> dict: dictionary with dns_server_sets and
dns_servers keys, then keyed by</span>
+<span class="sd"> dns_server_set and dns_server, respectively
ex:</span>
+<span class="sd"> {u'dns_server_sets':</span>
+<span class="sd"> {u'external_dns':</span>
+<span class="sd"> {'dns_servers':
[u'[
ns1.university.edu]',</span>
+<span class="sd">
u'[
dns2.university.edu]',</span>
+<span class="sd">
u'[
dns3.university.edu]']}</span>
+<span class="sd"> 'views':</span>
+<span class="sd"> {u'external':</span>
+<span class="sd"> {u'
university.edu':</span>
+<span class="sd"> {'records': [</span>
+<span class="sd"> {u'serial_number':
20091227,</span>
+<span class="sd">
u'refresh_seconds': 5,</span>
+<span class="sd"> 'target':
u'university.edu.',</span>
+<span class="sd"> u'name_server':
u'ns1.university.edu.',</span>
+<span class="sd"> u'retry_seconds':
5, 'ttl': 3600,</span>
+<span class="sd">
u'minimum_seconds': 5, 'record_type': u'soa',</span>
+<span class="sd"> 'view_name':
u'external',</span>
+<span class="sd"> 'last_user':
u'sharrell',</span>
+<span class="sd"> 'zone_name':
u'
university.edu',</span>
+<span class="sd"> u'admin_email':
u'ad...@university.edu.',</span>
+<span class="sd">
u'expiry_seconds': 5},</span>
+<span class="sd"> {'target':
u'computer1', 'ttl': 3600,</span>
+<span class="sd"> 'record_type':
u'a', 'view_name': u'external',</span>
+<span class="sd"> 'last_user':
u'sharrell',</span>
+<span class="sd"> 'zone_name':
u'
university.edu',</span>
+<span class="sd"> u'assignment_ip':
u'1.2.3.5'},</span>
+<span class="sd"> 'zone_origin':
u'example.',</span>
+<span class="sd"> 'zone_type':
u'master'}}}},</span>
+<span class="sd"> u'dns_servers':</span>
+<span class="sd"> {u'
ns1.university.edu':</span>
+<span class="sd">
{'dns_server_remote_bind_directory': u'/etc/named/',</span>
+<span class="sd">
'dns_server_remote_test_directory':
u'/etc/named/test/',</span>
+<span class="sd"> 'dns_server_ssh_username':
u'dchayes'},</span>
+<span class="sd"> u'
dns2.university.edu':</span>
+<span class="sd">
{'dns_server_remote_bind_directory': u'/etc/bind/',</span>
+<span class="sd">
'dns_server_remote_test_directory':
u'/etc/bind/test/',</span>
+<span class="sd"> 'dns_server_ssh_username':
u'ssh_user'}}}</span>
+<span class="sd"> u'
dns3.university.edu':</span>
+<span class="sd">
{'dns_server_remote_bind_directory': u'/etc/bind/',</span>
+<span class="sd">
'dns_server_remote_test_directory':
u'/etc/bind/test/',</span>
+<span class="sd"> 'dns_server_ssh_username':
u'dchayes'}}}</span>
+<span class="sd"> """</span>
+ <span class="n">cooked_data</span> <span class="o">=</span> <span
class="p">{}</span>
+ <span class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">]</span> <span
class="o">=</span> <span class="p">{}</span>
+ <span class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_servers'</span><span class="p">]</span> <span
class="o">=</span> <span class="p">{}</span>
+ <span class="n">sorted_records</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">SortRecords</span><span class="p">(</span><span
class="n">data</span><span class="p">[</span><span
class="s">'records'</span><span class="p">])</span>
+
+ <span class="k">for</span> <span class="n">dns_server_set</span> <span
class="ow">in</span> <span class="n">data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">]:</span>
+ <span class="n">dns_server_set_name</span> <span class="o">=</span>
<span class="n">dns_server_set</span><span class="p">[</span><span
class="s">'dns_server_set_name'</span><span class="p">]</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">dns_server_set_name</span> <span
class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">]</span> <span class="p">):</span>
+ <span class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set_name</span><span class="p">]</span> <span
class="o">=</span> <span class="p">{}</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="s">'dns_servers'</span> <span
class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span>
+ <span class="n">dns_server_set_name</span><span
class="p">]</span> <span class="p">):</span>
+ <span class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set_name</span><span class="p">][</span><span
class="s">'dns_servers'</span><span class="p">]</span> <span
class="o">=</span> <span class="p">[]</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="s">'views'</span> <span
class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set_name</span><span
class="p">]</span> <span class="p">):</span>
+ <span class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set_name</span><span class="p">][</span><span
class="s">'views'</span><span class="p">]</span> <span
class="o">=</span> <span class="p">{}</span>
+
+ <span class="k">for</span> <span
class="n">dns_server_set_assignment</span> <span class="ow">in</span> <span
class="n">data</span><span class="p">[</span><span
class="s">'dns_server_set_assignments'</span><span
class="p">]:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">dns_server_set_assignment</span><span class="p">[</span>
+ <span
class="s">'dns_server_set_assignments_dns_server_set_name'</span><span
class="p">]</span> <span class="o">==</span>
+ <span class="n">dns_server_set</span><span
class="p">[</span><span class="s">'dns_server_set_name'</span><span
class="p">]</span> <span class="ow">and</span>
+ <span class="n">dns_server_set_assignment</span><span
class="p">[</span>
+ <span
class="s">'dns_server_set_assignments_dns_server_name'</span><span
class="p">]</span>
+ <span class="ow">not</span> <span class="ow">in</span> <span
class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set_name</span><span class="p">][</span>
+ <span class="s">'dns_servers'</span><span
class="p">]</span> <span class="p">):</span>
+
+ <span class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set_name</span><span class="p">][</span>
+ <span class="s">'dns_servers'</span><span
class="p">]</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="n">dns_server_set_assignment</span><span class="p">[</span>
+ <span
class="s">'dns_server_set_assignments_dns_server_name'</span><span
class="p">])</span>
+
+ <span class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set_name</span><span class="p">][</span><span
class="s">'view_order'</span><span class="p">]</span> <span
class="o">=</span> <span class="p">{}</span>
+
+ <span class="k">for</span> <span
class="n">dns_server_set_view_assignment</span> <span class="ow">in</span>
<span class="n">data</span><span class="p">[</span>
+ <span
class="s">'dns_server_set_view_assignments'</span><span
class="p">]:</span>
+ <span class="n">dns_server_set_name</span> <span
class="o">=</span> <span
class="n">dns_server_set_view_assignment</span><span class="p">[</span>
+ <span
class="s">'dns_server_set_view_assignments_dns_server_set_name'</span><span
class="p">]</span>
+ <span class="n">view_name</span> <span class="o">=</span> <span
class="n">dns_server_set_view_assignment</span><span class="p">[</span>
+ <span
class="s">'dns_server_set_view_assignments_view_name'</span><span
class="p">]</span>
+ <span class="n">view_order</span> <span class="o">=</span> <span
class="n">dns_server_set_view_assignment</span><span
class="p">[</span><span class="s">'view_order'</span><span
class="p">]</span>
+ <span class="n">view_options</span> <span class="o">=</span> <span
class="n">dns_server_set_view_assignment</span><span
class="p">[</span><span class="s">'view_options'</span><span
class="p">]</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">dns_server_set_name</span> <span class="o">==</span> <span
class="n">dns_server_set</span><span class="p">[</span><span
class="s">'dns_server_set_name'</span><span class="p">]</span>
<span class="p">):</span>
+
+ <span class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_server_sets'</span><span class="p">][</span><span
class="n">dns_server_set_name</span><span class="p">][</span><span
class="s">'view_order'</span><span class="p">][</span>
+ <span class="n">view_order</span><span class="p">]</span>
<span class="o">=</span> <span class="n">view_name</span>
+
+ <span class="k">for</span> <span
class="n">view_dependency</span> <span class="ow">in</span> <span
class="n">data</span><span class="p">[</span><span
class="s">'view_dependency_assignments'</span><span
class="p">]:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">view_name</span> <span class="o">==</span> <span
class="n">view_dependency</span><span class="p">[</span>
+ <span
class="s">'view_dependency_assignments_view_name'</span><span
class="p">]</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">view_name</span> <span
class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span>
+ <span class="n">dns_server_set_name</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">]</span> <span class="p">):</span>
+ <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set_name</span><span
class="p">][</span>
+ <span class="s">'views'</span><span
class="p">][</span><span class="n">view_name</span><span class="p">]</span>
<span class="o">=</span> <span class="p">{}</span>
+
+ <span class="k">for</span> <span
class="n">view_names</span> <span class="ow">in</span> <span
class="n">data</span><span class="p">[</span><span
class="s">'views'</span><span class="p">]:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">view_names</span><span class="p">[</span><span
class="s">'view_name'</span><span class="p">]</span> <span
class="o">==</span> <span class="n">view_name</span> <span
class="p">):</span>
+ <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set_name</span><span
class="p">][</span>
+ <span class="s">'views'</span><span
class="p">][</span><span class="n">view_name</span><span
class="p">][</span><span class="s">'view_options'</span><span
class="p">]</span> <span class="o">=</span> <span class="p">(</span>
+ <span class="n">iscpy</span><span
class="o">.</span><span class="n">Deserialize</span><span
class="p">(</span><span class="n">view_options</span><span
class="p">)</span><span class="o">.</span><span
class="n">replace</span><span class="p">(</span><span
class="s">'</span><span class="se">\n</span><span
class="s">'</span><span class="p">,</span> <span
class="s">'</span><span class="se">\n\t</span><span
class="s">'</span><span class="p">))</span>
+ <span class="k">break</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="s">'acls'</span> <span
class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span>
+ <span class="n">dns_server_set_name</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span><span class="n">view_name</span><span class="p">]</span>
<span class="p">):</span>
+ <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set_name</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span>
+ <span class="n">view_name</span><span
class="p">][</span>
+ <span class="s">'acls'</span><span
class="p">]</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">ListACLNamesByView</span><span class="p">(</span><span
class="n">data</span><span class="p">,</span> <span
class="n">view_name</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="s">'zones'</span> <span
class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span>
+ <span class="n">dns_server_set_name</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span><span class="n">view_name</span><span class="p">]</span>
<span class="p">):</span>
+ <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set_name</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span>
+ <span class="n">view_name</span><span
class="p">][</span><span class="s">'zones'</span><span
class="p">]</span> <span class="o">=</span> <span class="p">{}</span>
+
+ <span class="k">for</span> <span class="n">zone</span> <span
class="ow">in</span> <span class="n">data</span><span
class="p">[</span><span
class="s">'zone_view_assignments'</span><span class="p">]:</span>
+ <span class="n">view_dependency_name</span> <span
class="o">=</span> <span class="n">view_dependency</span><span
class="p">[</span>
+ <span
class="s">'view_dependency_assignments_view_dependency'</span><span
class="p">]</span>
+ <span class="n">zone_name</span> <span class="o">=</span>
<span class="n">zone</span><span class="p">[</span><span
class="s">'zone_view_assignments_zone_name'</span><span
class="p">]</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">view_dependency_name</span> <span class="o">==</span> <span
class="n">zone</span><span class="p">[</span>
+ <span
class="s">'zone_view_assignments_view_dependency'</span><span
class="p">]</span> <span class="ow">and</span>
+ <span class="p">((</span><span
class="n">zone_name</span><span class="p">,</span> <span
class="n">view_dependency_name</span><span class="p">)</span> <span
class="ow">in</span> <span class="n">sorted_records</span> <span
class="ow">or</span>
+ <span class="n">zone</span><span
class="p">[</span><span
class="s">'zone_view_assignments_zone_type'</span><span
class="p">]</span> <span class="o">==</span> <span
class="s">'slave'</span><span class="p">)</span> <span
class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">zone_name</span> <span
class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span>
+ <span class="n">dns_server_set_name</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span><span class="n">view_name</span><span
class="p">][</span><span class="s">'zones'</span><span
class="p">]</span> <span class="p">):</span>
+ <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set_name</span><span
class="p">][</span>
+ <span class="s">'views'</span><span
class="p">][</span><span class="n">view_name</span><span
class="p">][</span><span class="s">'zones'</span><span
class="p">][</span><span class="n">zone_name</span><span class="p">]</span>
<span class="o">=</span> <span class="p">{}</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'records'</span> <span class="ow">not</span> <span
class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span>
+ <span class="n">dns_server_set_name</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span><span class="n">view_name</span><span
class="p">][</span><span class="s">'zones'</span><span
class="p">][</span>
+ <span class="n">zone_name</span><span
class="p">]</span> <span class="p">):</span>
+ <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set_name</span><span
class="p">][</span>
+ <span class="s">'views'</span><span
class="p">][</span><span class="n">view_name</span><span
class="p">][</span><span class="s">'zones'</span><span
class="p">][</span><span class="n">zone_name</span><span
class="p">][</span><span class="s">'records'</span><span
class="p">]</span> <span class="o">=</span> <span class="p">[]</span>
+
+
+ <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set_name</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span>
+ <span class="n">view_name</span><span
class="p">][</span><span class="s">'zones'</span><span
class="p">][</span><span class="n">zone_name</span><span
class="p">][</span><span class="s">'zone_origin'</span><span
class="p">]</span> <span class="o">=</span> <span class="p">(</span>
+ <span class="n">punycode_lib</span><span
class="o">.</span><span class="n">Uni2Puny</span><span
class="p">(</span><span class="n">zone</span><span class="p">[</span><span
class="s">'zone_origin'</span><span class="p">]))</span>
+
+ <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set_name</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span>
+ <span class="n">view_name</span><span
class="p">][</span><span class="s">'zones'</span><span
class="p">][</span><span class="n">zone_name</span><span class="p">][</span>
+ <span
class="s">'zone_options'</span><span class="p">]</span> <span
class="o">=</span> <span class="n">iscpy</span><span
class="o">.</span><span class="n">Deserialize</span><span
class="p">(</span><span class="n">zone</span><span class="p">[</span>
+ <span
class="s">'zone_options'</span><span class="p">])</span>
+
+ <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set_name</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span>
+ <span class="n">view_name</span><span
class="p">][</span><span class="s">'zones'</span><span
class="p">][</span><span class="n">zone_name</span><span
class="p">][</span><span class="s">'zone_type'</span><span
class="p">]</span> <span class="o">=</span> <span
class="n">zone</span><span class="p">[</span>
+ <span
class="s">'zone_view_assignments_zone_type'</span><span
class="p">]</span>
+
+ <span class="c"># if the zone is a slave</span>
+ <span class="k">if</span><span class="p">((</span><span
class="n">zone_name</span><span class="p">,</span> <span
class="n">view_dependency_name</span><span class="p">)</span> <span
class="ow">not</span> <span class="ow">in</span> <span
class="n">sorted_records</span><span class="p">):</span>
+ <span class="k">continue</span>
+
+ <span class="k">for</span> <span class="n">record</span>
<span class="ow">in</span> <span class="n">sorted_records</span><span
class="p">[(</span>
+ <span class="n">zone_name</span><span
class="p">,</span> <span class="n">view_dependency_name</span><span
class="p">)]</span><span class="o">.</span><span
class="n">values</span><span class="p">():</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">record</span><span
class="p">[</span><span class="s">'target'</span><span
class="p">]</span> <span class="o">=</span> <span
class="n">punycode_lib</span><span class="o">.</span><span
class="n">Uni2Puny</span><span class="p">(</span><span
class="n">record</span><span class="p">[</span><span
class="s">'target'</span><span class="p">])</span>
+ <span class="k">except</span> <span
class="p">(</span><span class="ne">KeyError</span><span class="p">):</span>
+ <span class="k">pass</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">record</span><span
class="p">[</span><span class="s">'assignment_host'</span><span
class="p">]</span> <span class="o">=</span> <span
class="n">punycode_lib</span><span class="o">.</span><span
class="n">Uni2Puny</span><span class="p">(</span>
+ <span class="n">record</span><span
class="p">[</span><span class="s">'assignment_host'</span><span
class="p">])</span>
+ <span class="k">except</span> <span
class="p">(</span><span class="ne">KeyError</span><span class="p">):</span>
+ <span class="k">pass</span>
+ <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_server_sets'</span><span
class="p">][</span><span class="n">dns_server_set_name</span><span
class="p">][</span><span class="s">'views'</span><span
class="p">][</span>
+ <span class="n">view_name</span><span
class="p">][</span><span class="s">'zones'</span><span
class="p">][</span><span class="n">zone_name</span><span class="p">][</span>
+ <span class="s">'records'</span><span
class="p">]</span><span class="o">.</span><span
class="n">extend</span><span class="p">(</span><span
class="n">sorted_records</span><span class="p">[(</span>
+ <span class="n">zone_name</span><span
class="p">,</span> <span class="n">view_dependency_name</span><span
class="p">)]</span><span class="o">.</span><span
class="n">values</span><span class="p">())</span>
+
+ <span class="c"># Insert dns_servers into cooked_data</span>
+ <span class="k">for</span> <span class="n">dns_server</span> <span
class="ow">in</span> <span class="n">data</span><span
class="p">[</span><span class="s">'dns_servers'</span><span
class="p">]:</span>
+ <span class="n">dns_server_name</span> <span class="o">=</span>
<span class="n">dns_server</span><span class="p">[</span><span
class="s">'dns_server_name'</span><span class="p">]</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">dns_server_name</span> <span
class="ow">in</span> <span class="n">cooked_data</span><span
class="p">[</span><span class="s">'dns_servers'</span><span
class="p">]</span> <span class="p">):</span>
+ <span class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_servers'</span><span class="p">][</span><span
class="n">dns_server_name</span><span class="p">]</span> <span
class="o">=</span> <span class="p">{}</span>
+ <span class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_servers'</span><span class="p">][</span><span
class="n">dns_server_name</span><span class="p">][</span><span
class="s">'dns_server_ssh_username'</span><span class="p">]</span>
<span class="o">=</span> <span class="p">(</span>
+ <span class="n">dns_server</span><span class="p">[</span><span
class="s">'dns_server_ssh_username'</span><span class="p">])</span>
+ <span class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_servers'</span><span class="p">][</span><span
class="n">dns_server_name</span><span class="p">][</span>
+ <span
class="s">'dns_server_remote_test_directory'</span><span
class="p">]</span> <span class="o">=</span> <span
class="n">dns_server</span><span class="p">[</span>
+ <span
class="s">'dns_server_remote_test_directory'</span><span
class="p">]</span>
+ <span class="n">cooked_data</span><span class="p">[</span><span
class="s">'dns_servers'</span><span class="p">][</span><span
class="n">dns_server_name</span><span class="p">][</span>
+ <span
class="s">'dns_server_remote_bind_directory'</span><span
class="p">]</span> <span class="o">=</span> <span
class="n">dns_server</span><span class="p">[</span>
+ <span
class="s">'dns_server_remote_bind_directory'</span><span
class="p">]</span>
+
+ <span class="k">return</span> <span
class="n">cooked_data</span></div></div>
+</pre></div>
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="../../search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
***The diff for this file has been truncated for email.***
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager/zone_exporter_lib.html
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,249 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="
http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>roster_config_manager.zone_exporter_lib — Roster Config
Manager v0.18 documentation</title>
+
+ <link rel="stylesheet" href="../../_static/default.css"
type="text/css" />
+ <link rel="stylesheet" href="../../_static/pygments.css"
type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: '../../',
+ VERSION: 'v0.18',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="../../_static/jquery.js"></script>
+ <script type="text/javascript"
src="../../_static/underscore.js"></script>
+ <script type="text/javascript"
src="../../_static/doctools.js"></script>
+ <link rel="top" title="Roster Config Manager v0.18 documentation"
href="../../index.html" />
+ <link rel="up" title="Module code" href="../index.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../../genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ <li><a href="../index.html" accesskey="U">Module code</a>
»</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <h1>Source code for roster_config_manager.zone_exporter_lib</h1><div
class="highlight"><pre>
+<span class="c">#!/usr/bin/python</span>
+
+<span class="c"># Copyright (c) 2009, Purdue University</span>
+<span class="c"># All rights reserved.</span>
+<span class="c">#</span>
+<span class="c"># Redistribution and use in source and binary forms, with
or without</span>
+<span class="c"># modification, are permitted provided that the following
conditions are met:</span>
+<span class="c">#</span>
+<span class="c"># Redistributions of source code must retain the above
copyright notice, this</span>
+<span class="c"># list of conditions and the following disclaimer.</span>
+<span class="c">#</span>
+<span class="c"># Redistributions in binary form must reproduce the above
copyright notice, this</span>
+<span class="c"># list of conditions and the following disclaimer in the
documentation and/or</span>
+<span class="c"># other materials provided with the distribution.</span>
+<span class="c">#</span>
+<span class="c"># Neither the name of the Purdue University nor the names
of its contributors</span>
+<span class="c"># may be used to endorse or promote products derived from
this software without</span>
+<span class="c"># specific prior written permission.</span>
+<span class="c">#</span>
+<span class="c"># THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS"</span>
+<span class="c"># AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
NOT LIMITED TO, THE</span>
+<span class="c"># IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE</span>
+<span class="c"># DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
CONTRIBUTORS BE LIABLE</span>
+<span class="c"># FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL</span>
+<span class="c"># DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR</span>
+<span class="c"># SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER</span>
+<span class="c"># CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY,</span>
+<span class="c"># OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE</span>
+<span class="c"># OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.</span>
+
+<span class="sd">"""This module contains all of the logic
for the zone exporter.</span>
+
+<span class="sd">It should be only called by the exporter.</span>
+<span class="sd">"""</span>
+
+<span class="n">__copyright__</span> <span class="o">=</span> <span
class="s">'Copyright (C) 2009, Purdue University'</span>
+<span class="n">__license__</span> <span class="o">=</span> <span
class="s">'BSD'</span>
+<span class="n">__version__</span> <span class="o">=</span> <span
class="s">'#TRUNK#'</span>
+
+
+<span class="kn">import</span> <span class="nn">roster_core</span>
+
+
+<span class="n">roster_core</span><span class="o">.</span><span
class="n">core</span><span class="o">.</span><span
class="n">CheckCoreVersionMatches</span><span class="p">(</span><span
class="n">__version__</span><span class="p">)</span>
+
+
+<div class="viewcode-block" id="Error"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.zone_exporter_lib.Error">[docs]</a><span
class="k">class</span> <span class="nc">Error</span><span
class="p">(</span><span class="n">roster_core</span><span
class="o">.</span><span class="n">CoreError</span><span class="p">):</span>
+ <span class="k">pass</span>
+
+</div>
+<div class="viewcode-block" id="ZoneError"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.zone_exporter_lib.ZoneError">[docs]</a><span
class="k">class</span> <span class="nc">ZoneError</span><span
class="p">(</span><span class="n">Error</span><span class="p">):</span>
+ <span class="k">pass</span>
+
+</div>
+<div class="viewcode-block" id="FormatRecordsForZone"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.zone_exporter_lib.FormatRecordsForZone">[docs]</a><span
class="k">def</span> <span class="nf">FormatRecordsForZone</span><span
class="p">(</span><span class="n">unsorted_records</span><span
class="p">,</span> <span class="n">origin</span><span class="p">,</span>
<span class="n">zone_name</span><span class="p">,</span> <span
class="n">view_name</span><span class="p">):</span>
+ <span class="sd">"""Gets the records from the db and
sorts them.</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> unsorted_records: unsorted records dictionary</span>
+<span class="sd"> origin: string of zone origin</span>
+<span class="sd"> zone_name: string of zone name</span>
+<span class="sd"> view_name: string of view name</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> dictionary keyed by record type with values of sorted
lists of</span>
+<span class="sd"> record dictionaries.</span>
+<span class="sd"> """</span>
+ <span class="n">pre_sorted_records</span> <span class="o">=</span> <span
class="p">{}</span>
+ <span class="n">sorted_records</span> <span class="o">=</span> <span
class="p">{}</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">unsorted_records</span> <span class="p">):</span>
+ <span class="n">sorted_records</span><span class="p">[</span><span
class="s">'bulk'</span><span class="p">]</span> <span
class="o">=</span> <span class="p">[]</span>
+ <span class="k">for</span> <span class="n">record</span> <span
class="ow">in</span> <span class="n">unsorted_records</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">record</span><span
class="p">[</span><span class="s">'record_type'</span><span
class="p">]</span> <span class="ow">in</span> <span
class="n">pre_sorted_records</span> <span class="p">):</span>
+ <span class="n">pre_sorted_records</span><span
class="p">[</span><span class="n">record</span><span
class="p">[</span><span class="s">'record_type'</span><span
class="p">]]</span> <span class="o">=</span> <span class="p">[]</span>
+ <span class="n">pre_sorted_records</span><span class="p">[</span><span
class="n">record</span><span class="p">[</span><span
class="s">'record_type'</span><span class="p">]]</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="n">record</span><span class="p">)</span>
+ <span class="k">for</span> <span class="n">record_type</span> <span
class="ow">in</span> <span class="n">pre_sorted_records</span><span
class="o">.</span><span class="n">keys</span><span class="p">():</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record_type</span> <span class="o">==</span> <span
class="s">'mx'</span> <span class="p">):</span>
+ <span class="n">sorted_records</span><span class="p">[</span><span
class="n">record_type</span><span class="p">]</span> <span
class="o">=</span> <span class="nb">sorted</span><span
class="p">(</span><span class="n">pre_sorted_records</span><span
class="p">[</span><span class="n">record_type</span><span
class="p">],</span>
+ <span class="n">key</span><span
class="o">=</span><span class="k">lambda</span> <span
class="n">k</span><span class="p">:</span> <span class="n">k</span><span
class="p">[</span><span class="s">'priority'</span><span
class="p">])</span>
+
+ <span class="k">elif</span><span class="p">(</span> <span
class="n">record_type</span> <span class="o">==</span> <span
class="s">'ns'</span> <span class="p">):</span>
+ <span class="n">sorted_records</span><span class="p">[</span><span
class="n">record_type</span><span class="p">]</span> <span
class="o">=</span> <span class="nb">sorted</span><span
class="p">(</span><span class="n">pre_sorted_records</span><span
class="p">[</span><span class="n">record_type</span><span
class="p">],</span>
+ <span class="n">key</span><span
class="o">=</span><span class="k">lambda</span> <span
class="n">k</span><span class="p">:</span> <span class="n">k</span><span
class="p">[</span><span class="s">'name_server'</span><span
class="p">])</span>
+
+ <span class="k">elif</span><span class="p">(</span> <span
class="n">record_type</span> <span class="ow">in</span> <span
class="p">(</span><span class="s">'soa'</span><span
class="p">,</span> <span class="s">'txt'</span><span
class="p">)</span> <span class="p">):</span>
+ <span class="n">sorted_records</span><span class="p">[</span><span
class="n">record_type</span><span class="p">]</span> <span
class="o">=</span> <span class="n">pre_sorted_records</span><span
class="p">[</span><span class="n">record_type</span><span class="p">]</span>
+
+ <span class="k">else</span><span class="p">:</span>
+ <span class="c"># put the rest of the records together and sort them
by target</span>
+ <span class="n">sorted_records</span><span class="p">[</span><span
class="s">'bulk'</span><span class="p">]</span><span
class="o">.</span><span class="n">extend</span><span
class="p">(</span><span class="n">pre_sorted_records</span><span
class="p">[</span><span class="n">record_type</span><span
class="p">])</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="n">unsorted_records</span> <span class="p">):</span>
+ <span class="n">sorted_records</span><span class="p">[</span><span
class="s">'bulk'</span><span class="p">]</span> <span
class="o">=</span> <span class="nb">sorted</span><span
class="p">(</span><span class="n">sorted_records</span><span
class="p">[</span><span class="s">'bulk'</span><span
class="p">],</span>
+ <span class="n">key</span><span
class="o">=</span><span class="k">lambda</span> <span
class="n">k</span><span class="p">:</span> <span class="n">k</span><span
class="p">[</span><span class="s">'target'</span><span
class="p">])</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="s">'soa'</span> <span class="ow">in</span> <span
class="n">sorted_records</span> <span class="p">):</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="nb">len</span><span class="p">(</span><span
class="n">sorted_records</span><span class="p">[</span><span
class="s">'soa'</span><span class="p">])</span> <span
class="o">==</span> <span class="mi">1</span> <span class="p">):</span>
+ <span class="n">soa_origin</span> <span class="o">=</span> <span
class="n">sorted_records</span><span class="p">[</span><span
class="s">'soa'</span><span class="p">][</span><span
class="mi">0</span><span class="p">][</span><span
class="s">'target'</span><span class="p">]</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">soa_origin</span> <span class="o">!=</span> <span
class="n">origin</span> <span class="ow">and</span> <span
class="n">soa_origin</span> <span class="o">!=</span> <span
class="s">u'@'</span> <span class="p">):</span>
+ <span class="k">raise</span> <span class="n">Error</span><span
class="p">(</span><span class="s">'SOA origin "</span><span
class="si">%s</span><span class="s">" and zone origin
"</span><span class="si">%s</span><span class="s">" do not
match.'</span> <span class="o">%</span> <span class="p">(</span>
+ <span class="n">soa_origin</span><span class="p">,</span>
<span class="n">origin</span><span class="p">))</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">for</span> <span class="n">record</span> <span
class="ow">in</span> <span class="n">sorted_records</span><span
class="p">[</span><span class="s">'soa'</span><span
class="p">]:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record</span><span class="p">[</span><span
class="s">'view_name'</span><span class="p">]</span> <span
class="o">==</span> <span class="s">u'any'</span> <span
class="p">):</span>
+ <span class="k">raise</span> <span class="n">Error</span><span
class="p">(</span><span class="s">'SOA record found in "any"
view in "</span><span class="si">%s</span><span class="s">"
zone.'</span> <span class="o">%</span> <span class="p">(</span>
+ <span class="n">record</span><span class="p">[</span><span
class="s">'zone_name'</span><span class="p">]))</span>
+ <span class="k">raise</span> <span class="n">Error</span><span
class="p">(</span><span class="s">'Multiple SOA records found for
"</span><span class="si">%s</span><span class="s">" zone
"</span><span class="si">%s</span><span class="s">"
view'</span> <span class="o">%</span> <span class="p">(</span>
+ <span class="n">zone_name</span><span class="p">,</span> <span
class="n">view_name</span><span class="p">))</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">raise</span> <span class="n">Error</span><span
class="p">(</span><span class="s">'No SOA records found for zone
"</span><span class="si">%s</span><span class="s">" view
"</span><span class="si">%s</span><span class="s">"'</span>
<span class="o">%</span> <span class="p">(</span><span
class="n">zone_name</span><span class="p">,</span>
+ <span
class="n">view_name</span><span class="p">))</span>
+
+ <span class="k">return</span> <span class="n">sorted_records</span>
+</div>
+<div class="viewcode-block" id="MakeZoneString"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.zone_exporter_lib.MakeZoneString">[docs]</a><span
class="k">def</span> <span class="nf">MakeZoneString</span><span
class="p">(</span><span class="n">records</span><span class="p">,</span>
<span class="n">zone_origin</span><span class="p">,</span> <span
class="n">argument_definitions</span><span class="p">,</span> <span
class="n">zone_name</span><span class="p">,</span>
+ <span class="n">view_name</span><span
class="p">):</span>
+ <span class="sd">"""Makes zone string that can be written
to a file.</span>
+<span class="sd"> Inputs:</span>
+<span class="sd"> records: dictionary of sorted records</span>
+<span class="sd"> zone_origin: string of zone origin</span>
+<span class="sd"> argument_definitions: dictionary of argument
definitions</span>
+<span class="sd"> zone_name: string of zone name</span>
+<span class="sd"> view_name: string of view name</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> string of exported zone file.</span>
+<span class="sd"> """</span>
+ <span class="n">records</span> <span class="o">=</span> <span
class="n">FormatRecordsForZone</span><span class="p">(</span><span
class="n">records</span><span class="p">,</span> <span
class="n">zone_origin</span><span class="p">,</span> <span
class="n">zone_name</span><span class="p">,</span> <span
class="n">view_name</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">records</span><span
class="o">.</span><span class="n">has_key</span><span
class="p">(</span><span class="s">'soa'</span><span
class="p">)</span> <span class="p">):</span>
+ <span class="k">raise</span> <span class="n">ZoneError</span><span
class="p">(</span><span class="s">'SOA not found for zone </span><span
class="si">%s</span><span class="s">'</span> <span class="o">%</span>
<span class="n">zone_name</span><span class="p">)</span>
+
+ <span class="n">zone_string_list</span> <span class="o">=</span> <span
class="p">[</span><span class="s">'; This zone file is autogenerated.
DO NOT EDIT.'</span><span class="p">,</span>
+ <span class="s">'$ORIGIN </span><span
class="si">%s</span><span class="s">'</span> <span class="o">%</span>
<span class="n">zone_origin</span><span class="p">]</span>
+ <span class="n">begining_record_order</span> <span class="o">=</span>
<span class="p">[</span><span class="s">'soa'</span><span
class="p">,</span> <span class="s">'ns'</span><span
class="p">,</span> <span class="s">'mx'</span><span
class="p">,</span> <span class="s">'txt'</span><span
class="p">]</span>
+
+ <span class="k">for</span> <span class="n">record_type</span> <span
class="ow">in</span> <span class="n">begining_record_order</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">record_type</span> <span class="ow">not</span> <span
class="ow">in</span> <span class="n">records</span> <span
class="p">):</span>
+ <span class="k">continue</span>
+ <span class="k">for</span> <span class="n">current_record</span> <span
class="ow">in</span> <span class="n">records</span><span
class="p">[</span><span class="n">record_type</span><span
class="p">]:</span>
+ <span class="n">line_list</span> <span class="o">=</span> <span
class="p">[</span><span class="n">current_record</span><span
class="p">[</span><span class="s">'target'</span><span
class="p">],</span> <span class="nb">str</span><span
class="p">(</span><span class="n">current_record</span><span
class="p">[</span><span class="s">'ttl'</span><span
class="p">]),</span> <span class="s">'in'</span><span
class="p">,</span>
+ <span class="n">current_record</span><span
class="p">[</span><span class="s">'record_type'</span><span
class="p">]]</span>
+
+ <span class="k">for</span> <span class="n">arg_def</span> <span
class="ow">in</span> <span class="n">argument_definitions</span><span
class="p">[</span><span class="n">record_type</span><span
class="p">]:</span>
+ <span class="n">line_list</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="nb">str</span><span class="p">(</span><span
class="n">current_record</span><span class="p">[</span><span
class="n">arg_def</span><span class="p">[</span><span
class="s">'argument_name'</span><span class="p">]]))</span>
+
+ <span class="n">zone_string_list</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span class="s">'
'</span><span class="o">.</span><span class="n">join</span><span
class="p">(</span><span class="n">line_list</span><span class="p">))</span>
+
+ <span class="k">for</span> <span class="n">current_record</span> <span
class="ow">in</span> <span class="n">records</span><span
class="p">[</span><span class="s">'bulk'</span><span
class="p">]:</span>
+ <span class="n">line_list</span> <span class="o">=</span> <span
class="p">[</span><span class="n">current_record</span><span
class="p">[</span><span class="s">'target'</span><span
class="p">],</span> <span class="nb">str</span><span
class="p">(</span><span class="n">current_record</span><span
class="p">[</span><span class="s">'ttl'</span><span
class="p">]),</span> <span class="s">'in'</span><span
class="p">,</span>
+ <span class="n">current_record</span><span
class="p">[</span><span class="s">'record_type'</span><span
class="p">]]</span>
+
+ <span class="k">for</span> <span class="n">arg_def</span> <span
class="ow">in</span> <span class="n">argument_definitions</span><span
class="p">[</span><span class="n">current_record</span><span
class="p">[</span><span class="s">'record_type'</span><span
class="p">]]:</span>
+ <span class="n">line_list</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="nb">str</span><span class="p">(</span><span
class="n">current_record</span><span class="p">[</span><span
class="n">arg_def</span><span class="p">[</span><span
class="s">'argument_name'</span><span class="p">]]))</span>
+
+ <span class="n">zone_string_list</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span class="s">'
'</span><span class="o">.</span><span class="n">join</span><span
class="p">(</span><span class="n">line_list</span><span class="p">))</span>
+
+ <span class="k">return</span> <span class="s">'</span><span
class="si">%s</span><span class="se">\n</span><span class="s">'</span>
<span class="o">%</span> <span class="s">'</span><span
class="se">\n</span><span class="s">'</span><span
class="o">.</span><span class="n">join</span><span class="p">(</span><span
class="n">zone_string_list</span><span class="p">)</span></div>
+</pre></div>
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="../../search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../../genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ <li><a href="../index.html" >Module code</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2013, Purdue University.
+ Created using <a href="
http://sphinx-doc.org/">Sphinx</a> 1.2b1.
+ </div>
+ </body>
+</html>
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_modules/roster_config_manager/zone_importer_lib.html
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,275 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="
http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>roster_config_manager.zone_importer_lib — Roster Config
Manager v0.18 documentation</title>
+
+ <link rel="stylesheet" href="../../_static/default.css"
type="text/css" />
+ <link rel="stylesheet" href="../../_static/pygments.css"
type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: '../../',
+ VERSION: 'v0.18',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="../../_static/jquery.js"></script>
+ <script type="text/javascript"
src="../../_static/underscore.js"></script>
+ <script type="text/javascript"
src="../../_static/doctools.js"></script>
+ <link rel="top" title="Roster Config Manager v0.18 documentation"
href="../../index.html" />
+ <link rel="up" title="Module code" href="../index.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../../genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ <li><a href="../index.html" accesskey="U">Module code</a>
»</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <h1>Source code for roster_config_manager.zone_importer_lib</h1><div
class="highlight"><pre>
+<span class="c">#!/usr/bin/python</span>
+
+<span class="c"># Copyright (c) 2009, Purdue University</span>
+<span class="c"># All rights reserved.</span>
+<span class="c">#</span>
+<span class="c"># Redistribution and use in source and binary forms, with
or without</span>
+<span class="c"># modification, are permitted provided that the following
conditions are met:</span>
+<span class="c">#</span>
+<span class="c"># Redistributions of source code must retain the above
copyright notice, this</span>
+<span class="c"># list of conditions and the following disclaimer.</span>
+<span class="c">#</span>
+<span class="c"># Redistributions in binary form must reproduce the above
copyright notice, this</span>
+<span class="c"># list of conditions and the following disclaimer in the
documentation and/or</span>
+<span class="c"># other materials provided with the distribution.</span>
+<span class="c">#</span>
+<span class="c"># Neither the name of the Purdue University nor the names
of its contributors</span>
+<span class="c"># may be used to endorse or promote products derived from
this software without</span>
+<span class="c"># specific prior written permission.</span>
+<span class="c">#</span>
+<span class="c"># THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS"</span>
+<span class="c"># AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
NOT LIMITED TO, THE</span>
+<span class="c"># IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE</span>
+<span class="c"># DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
CONTRIBUTORS BE LIABLE</span>
+<span class="c"># FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL</span>
+<span class="c"># DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR</span>
+<span class="c"># SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER</span>
+<span class="c"># CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY,</span>
+<span class="c"># OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE</span>
+<span class="c"># OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.</span>
+
+<span class="sd">"""This module contains all of the logic
for the zone importer.</span>
+
+<span class="sd">It should be only called by the importer.</span>
+<span class="sd">"""</span>
+
+<span class="n">__copyright__</span> <span class="o">=</span> <span
class="s">'Copyright (C) 2009, Purdue University'</span>
+<span class="n">__license__</span> <span class="o">=</span> <span
class="s">'BSD'</span>
+<span class="n">__version__</span> <span class="o">=</span> <span
class="s">'#TRUNK#'</span>
+
+<span class="kn">import</span> <span class="nn">os</span>
+
+<span class="kn">import</span> <span class="nn">dns.zone</span>
+<span class="kn">import</span> <span class="nn">IPy</span>
+<span class="kn">import</span> <span class="nn">roster_core</span>
+<span class="kn">from</span> <span class="nn">roster_core</span> <span
class="kn">import</span> <span class="n">errors</span>
+
+
+<span class="n">roster_core</span><span class="o">.</span><span
class="n">core</span><span class="o">.</span><span
class="n">CheckCoreVersionMatches</span><span class="p">(</span><span
class="n">__version__</span><span class="p">)</span>
+
+
+<div class="viewcode-block" id="Error"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.zone_importer_lib.Error">[docs]</a><span
class="k">class</span> <span class="nc">Error</span><span
class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
+ <span class="k">pass</span>
+</div>
+<div class="viewcode-block" id="IncludeError"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.zone_importer_lib.IncludeError">[docs]</a><span
class="k">class</span> <span class="nc">IncludeError</span><span
class="p">(</span><span class="n">Error</span><span class="p">):</span>
+ <span class="k">pass</span>
+</div>
+<div class="viewcode-block" id="ZoneImport"><a class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.zone_importer_lib.ZoneImport">[docs]</a><span
class="k">class</span> <span class="nc">ZoneImport</span><span
class="p">(</span><span class="nb">object</span><span class="p">):</span>
+ <span class="sd">"""This class will only import one zone
per init. It will load the zone</span>
+<span class="sd"> from a file using dns.zone and then use the core API to
put it in</span>
+<span class="sd"> the database.</span>
+<span class="sd"> """</span>
+ <span class="k">def</span> <span class="nf">__init__</span><span
class="p">(</span><span class="bp">self</span><span class="p">,</span>
<span class="n">zone_file_name</span><span class="p">,</span> <span
class="n">config_file_name</span><span class="p">,</span> <span
class="n">user_name</span><span class="p">,</span> <span
class="n">view</span><span class="p">,</span>
+ <span class="n">zone_name</span><span class="p">):</span>
+ <span class="sd">"""Sets self.core_instance, self.zone
self.domain and self.view.</span>
+
+<span class="sd"> Inputs:</span>
+<span class="sd"> zone_file_name: name of zone file to import</span>
+<span class="sd"> config_file_name: name of config file to load db
info from</span>
+<span class="sd"> user_name: username of person running the
script</span>
+<span class="sd"> view: name of view to import records to</span>
+<span class="sd"> zone_name: name of the zone to import records
to</span>
+<span class="sd"> """</span>
+ <span class="n">config_instance</span> <span class="o">=</span> <span
class="n">roster_core</span><span class="o">.</span><span
class="n">Config</span><span class="p">(</span><span
class="n">file_name</span><span class="o">=</span><span
class="n">config_file_name</span><span class="p">)</span>
+
+ <span class="bp">self</span><span class="o">.</span><span
class="n">core_instance</span> <span class="o">=</span> <span
class="n">roster_core</span><span class="o">.</span><span
class="n">Core</span><span class="p">(</span><span
class="n">user_name</span><span class="p">,</span> <span
class="n">config_instance</span><span class="p">)</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">core_helper_instance</span> <span class="o">=</span> <span
class="n">roster_core</span><span class="o">.</span><span
class="n">CoreHelpers</span><span class="p">(</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">core_instance</span><span class="p">)</span>
+
+ <span class="n">zone_file_dir</span> <span class="o">=</span> <span
class="n">os</span><span class="o">.</span><span class="n">path</span><span
class="o">.</span><span class="n">dirname</span><span
class="p">(</span><span class="n">zone_file_name</span><span
class="p">)</span>
+ <span class="n">zone_lines</span> <span class="o">=</span> <span
class="p">[]</span>
+ <span class="n">zone_file</span> <span class="o">=</span> <span
class="nb">open</span><span class="p">(</span><span
class="n">zone_file_name</span><span class="p">,</span> <span
class="s">'r'</span><span class="p">)</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="k">for</span> <span class="n">line</span> <span
class="ow">in</span> <span class="n">zone_file</span><span
class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">line</span><span class="o">.</span><span
class="n">startswith</span><span class="p">(</span><span
class="s">'$INCLUDE'</span><span class="p">)</span> <span
class="p">):</span>
+ <span class="n">include_file_name</span> <span
class="o">=</span> <span class="n">line</span><span class="o">.</span><span
class="n">split</span><span class="p">(</span><span
class="s">'$INCLUDE'</span><span class="p">)[</span><span
class="mi">1</span><span class="p">]</span><span class="o">.</span><span
class="n">lstrip</span><span class="p">()</span><span
class="o">.</span><span class="n">rstrip</span><span class="p">()</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">include_file_name</span><span
class="o">.</span><span class="n">startswith</span><span
class="p">(</span><span class="s">'/'</span><span
class="p">)</span> <span class="p">):</span>
+ <span class="n">include_file_name</span> <span
class="o">=</span> <span class="n">os</span><span class="o">.</span><span
class="n">path</span><span class="o">.</span><span
class="n">join</span><span class="p">(</span><span
class="n">zone_file_dir</span><span class="p">,</span> <span
class="n">include_file_name</span><span class="p">)</span>
+
+ <span class="n">include_lines</span> <span class="o">=</span>
<span class="p">[]</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">include_file</span> <span class="o">=</span>
<span class="nb">open</span><span class="p">(</span><span
class="n">include_file_name</span><span class="p">,</span> <span
class="s">'r'</span><span class="p">)</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="k">for</span> <span class="n">line</span> <span
class="ow">in</span> <span class="n">include_file</span><span
class="p">:</span>
+ <span class="n">include_lines</span><span
class="o">.</span><span class="n">append</span><span
class="p">(</span><span class="n">line</span><span class="p">)</span>
+ <span class="k">finally</span><span class="p">:</span>
+ <span class="n">include_file</span><span
class="o">.</span><span class="n">close</span><span class="p">()</span>
+ <span class="k">except</span> <span
class="ne">IOError</span><span class="p">:</span>
+ <span class="k">raise</span> <span
class="n">IncludeError</span><span class="p">(</span><span
class="s">'Unable to import include file: </span><span
class="si">%s</span><span class="s">'</span> <span class="o">%</span>
<span class="n">include_file_name</span><span class="p">)</span>
+
+ <span class="n">zone_lines</span><span class="o">.</span><span
class="n">extend</span><span class="p">(</span><span
class="n">include_lines</span><span class="p">)</span>
+ <span class="k">continue</span>
+
+ <span class="n">zone_lines</span><span class="o">.</span><span
class="n">append</span><span class="p">(</span><span
class="n">line</span><span class="p">)</span>
+
+ <span class="k">finally</span><span class="p">:</span>
+ <span class="n">zone_file</span><span class="o">.</span><span
class="n">close</span><span class="p">()</span>
+
+
+ <span class="bp">self</span><span class="o">.</span><span
class="n">zone_file_string</span> <span class="o">=</span> <span
class="nb">unicode</span><span class="p">(</span><span
class="s">'</span><span class="se">\n</span><span
class="s">'</span><span class="o">.</span><span
class="n">join</span><span class="p">(</span><span
class="n">zone_lines</span><span class="p">))</span>
+
+ <span class="bp">self</span><span class="o">.</span><span
class="n">zone_name</span> <span class="o">=</span> <span
class="n">zone_name</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">view</span> <span class="o">=</span> <span class="n">view</span>
+
+ <span class="n">zones_dict</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">core_instance</span><span class="o">.</span><span
class="n">ListZones</span><span class="p">(</span><span
class="n">zone_name</span><span class="o">=</span><span
class="n">zone_name</span><span class="p">)</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">zone_name</span> <span class="ow">in</span> <span
class="n">zones_dict</span> <span class="p">):</span>
+ <span class="n">zones_dict</span> <span class="o">=</span> <span
class="n">zones_dict</span><span class="p">[</span><span
class="n">zone_name</span><span class="p">]</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="n">view</span> <span class="ow">in</span> <span
class="n">zones_dict</span> <span class="p">):</span>
+ <span class="n">zones_dict</span> <span class="o">=</span> <span
class="n">zones_dict</span><span class="p">[</span><span
class="n">view</span><span class="p">]</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">origin</span> <span class="o">=</span> <span
class="n">zones_dict</span><span class="p">[</span><span
class="s">u'zone_origin'</span><span class="p">]</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">raise</span> <span class="n">errors</span><span
class="o">.</span><span class="n">InvalidInputError</span><span
class="p">(</span><span class="s">'View </span><span
class="si">%s</span><span class="s"> does not exist.'</span> <span
class="o">%</span> <span class="n">view</span><span class="p">)</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">raise</span> <span class="n">errors</span><span
class="o">.</span><span class="n">InvalidInputError</span><span
class="p">(</span><span class="s">'Zone </span><span
class="si">%s</span><span class="s"> does not exist.'</span> <span
class="o">%</span> <span class="n">zone_name</span><span class="p">)</span>
+
+ <span class="bp">self</span><span class="o">.</span><span
class="n">all_views</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">core_instance</span><span class="o">.</span><span
class="n">ListZones</span><span class="p">(</span><span
class="n">zone_name</span><span class="o">=</span><span
class="n">zone_name</span><span class="p">)[</span>
+ <span class="n">zone_name</span><span class="p">]</span>
+
+
+<div class="viewcode-block" id="ZoneImport.ReverseZoneToCIDRBlock"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.zone_importer_lib.ZoneImport.ReverseZoneToCIDRBlock">[docs]</a>
<span class="k">def</span> <span
class="nf">ReverseZoneToCIDRBlock</span><span class="p">(</span><span
class="bp">self</span><span class="p">):</span>
+ <span class="sd">"""Creates CIDR block from reverse
zone name.</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> string of cidr block</span>
+<span class="sd"> """</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">origin</span><span class="o">.</span><span
class="n">endswith</span><span class="p">(</span><span
class="s">'in-addr.arpa.'</span><span class="p">)</span> <span
class="p">):</span>
+ <span class="n">ip_parts</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">origin</span><span class="o">.</span><span
class="n">split</span><span class="p">(</span><span
class="s">'.in-'</span><span class="p">)[</span><span
class="mi">0</span><span class="p">]</span><span class="o">.</span><span
class="n">split</span><span class="p">(</span><span
class="s">'.'</span><span class="p">)</span>
+ <span class="n">ip_parts</span><span class="o">.</span><span
class="n">reverse</span><span class="p">()</span>
+ <span class="k">for</span> <span class="n">ip_part</span> <span
class="ow">in</span> <span class="n">ip_parts</span><span class="p">:</span>
+ <span class="k">if</span><span class="p">(</span> <span
class="ow">not</span> <span class="n">ip_part</span><span
class="o">.</span><span class="n">isdigit</span><span class="p">()</span>
<span class="p">):</span>
+ <span class="k">raise</span> <span class="n">Error</span><span
class="p">(</span><span class="s">'</span><span
class="si">%s</span><span class="s"> is not a reverse zone.'</span>
<span class="o">%</span> <span class="bp">self</span><span
class="o">.</span><span class="n">zone_name</span><span class="p">)</span>
+
+ <span class="n">cidr_block</span> <span class="o">=</span> <span
class="s">'.'</span><span class="o">.</span><span
class="n">join</span><span class="p">(</span><span
class="n">ip_parts</span><span class="p">)</span>
+ <span class="n">ip_octets</span> <span class="o">=</span> <span
class="nb">len</span><span class="p">(</span><span
class="n">ip_parts</span><span class="p">)</span>
+
+ <span class="k">if</span><span class="p">(</span> <span
class="n">ip_octets</span> <span class="o">></span> <span
class="mi">3</span> <span class="ow">or</span> <span
class="n">ip_octets</span> <span class="o"><</span> <span
class="mi">1</span> <span class="p">):</span>
+ <span class="k">raise</span> <span class="n">Error</span><span
class="p">(</span><span class="s">'</span><span
class="si">%s</span><span class="s"> is not a reverse zone.'</span>
<span class="o">%</span> <span class="bp">self</span><span
class="o">.</span><span class="n">zone_name</span><span class="p">)</span>
+
+ <span class="n">cidr_block</span> <span class="o">=</span> <span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="n">cidr_block</span><span class="p">,</span> <span
class="n">ip_octets</span> <span class="o">*</span> <span
class="mi">8</span><span class="p">)</span>
+
+ <span class="k">elif</span><span class="p">(</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">origin</span><span class="o">.</span><span
class="n">endswith</span><span class="p">(</span><span
class="s">'ip6.arpa.'</span><span class="p">)</span> <span
class="p">):</span>
+ <span class="n">ip_parts</span> <span class="o">=</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">origin</span><span class="o">.</span><span
class="n">split</span><span class="p">(</span><span
class="s">'.ip6'</span><span class="p">)[</span><span
class="mi">0</span><span class="p">]</span><span class="o">.</span><span
class="n">split</span><span class="p">(</span><span
class="s">'.'</span><span class="p">)</span>
+ <span class="n">ip_parts</span><span class="o">.</span><span
class="n">reverse</span><span class="p">()</span>
+ <span class="n">ip_quartets</span> <span class="o">=</span> <span
class="nb">len</span><span class="p">(</span><span
class="n">ip_parts</span><span class="p">)</span>
+
+ <span class="k">for</span> <span class="n">ip_part</span> <span
class="ow">in</span> <span class="n">ip_parts</span><span class="p">:</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="nb">int</span><span class="p">(</span><span
class="n">ip_part</span><span class="p">,</span> <span
class="mi">16</span><span class="p">)</span>
+ <span class="k">except</span> <span
class="ne">ValueError</span><span class="p">:</span>
+ <span class="k">raise</span> <span class="n">Error</span><span
class="p">(</span><span class="s">'Invalid hexidecimal number in ipv6
origin: </span><span class="si">%s</span><span class="s">'</span> <span
class="o">%</span>
+ <span class="bp">self</span><span
class="o">.</span><span class="n">origin</span><span class="p">)</span>
+ <span class="c"># fill out the rest of the ipv6 address</span>
+ <span class="n">ip_parts</span><span class="o">.</span><span
class="n">extend</span><span class="p">([</span><span
class="s">'0'</span> <span class="k">for</span> <span
class="n">x</span> <span class="ow">in</span> <span
class="nb">range</span><span class="p">(</span><span
class="mi">32</span><span class="o">-</span><span
class="n">ip_quartets</span><span class="p">)])</span>
+
+ <span class="k">for</span> <span class="n">x</span> <span
class="ow">in</span> <span class="nb">range</span><span
class="p">(</span><span class="mi">1</span><span class="p">,</span> <span
class="mi">8</span><span class="p">):</span>
+ <span class="c"># Put colons every 4 quartets</span>
+ <span class="n">ip_parts</span><span class="o">.</span><span
class="n">insert</span><span class="p">((</span><span
class="n">x</span><span class="o">*</span><span class="mi">4</span><span
class="p">)</span><span class="o">+</span><span class="p">(</span><span
class="n">x</span><span class="o">-</span><span class="mi">1</span><span
class="p">),</span> <span class="s">':'</span><span
class="p">)</span>
+ <span class="n">cidr_block</span> <span class="o">=</span> <span
class="s">''</span><span class="o">.</span><span
class="n">join</span><span class="p">(</span><span
class="n">ip_parts</span><span class="p">)</span>
+
+ <span class="n">cidr_block</span> <span class="o">=</span> <span
class="s">'</span><span class="si">%s</span><span
class="s">/</span><span class="si">%s</span><span class="s">'</span>
<span class="o">%</span> <span class="p">(</span><span
class="n">cidr_block</span><span class="p">,</span> <span
class="n">ip_quartets</span> <span class="o">*</span> <span
class="mi">4</span><span class="p">)</span>
+
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">raise</span> <span class="n">Error</span><span
class="p">(</span><span class="s">'</span><span
class="si">%s</span><span class="s"> is not a reverse zone.'</span>
<span class="o">%</span> <span class="bp">self</span><span
class="o">.</span><span class="n">zone_name</span><span class="p">)</span>
+
+ <span class="k">return</span> <span class="n">cidr_block</span>
+ </div>
+<div class="viewcode-block" id="ZoneImport.MakeRecordsFromZone"><a
class="viewcode-back"
href="../../roster_config_manager.html#roster_config_manager.zone_importer_lib.ZoneImport.MakeRecordsFromZone">[docs]</a>
<span class="k">def</span> <span class="nf">MakeRecordsFromZone</span><span
class="p">(</span><span class="bp">self</span><span class="p">):</span>
+ <span class="sd">"""Makes records in the database from
dns.zone class.</span>
+
+<span class="sd"> Outputs:</span>
+<span class="sd"> int: Amount of records added to db.</span>
+<span class="sd"> """</span>
+ <span class="k">return</span> <span class="bp">self</span><span
class="o">.</span><span class="n">core_helper_instance</span><span
class="o">.</span><span class="n">AddFormattedRecords</span><span
class="p">(</span>
+ <span class="bp">self</span><span class="o">.</span><span
class="n">zone_name</span><span class="p">,</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">zone_file_string</span><span class="p">,</span> <span
class="bp">self</span><span class="o">.</span><span
class="n">view</span><span class="p">)</span></div></div>
+</pre></div>
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="../../search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../../genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ <li><a href="../index.html" >Module code</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2013, Purdue University.
+ Created using <a href="
http://sphinx-doc.org/">Sphinx</a> 1.2b1.
+ </div>
+ </body>
+</html>
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/_sources/index.txt
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,23 @@
+.. Roster Config Manager documentation master file, created by
+ sphinx-quickstart on Mon Aug 19 13:04:30 2013.
+ You can adapt this file completely to your liking, but it should at
least
+ contain the root `toctree` directive.
+
+Welcome to Roster Config Manager's documentation!
+=================================================
+
+Contents:
+
+.. toctree::
+ :maxdepth: 4
+
+ roster_config_manager
+
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
+
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_sources/roster_config_manager.txt
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,59 @@
+roster_config_manager Package
+=============================
+
+:mod:`roster_config_manager` Package
+------------------------------------
+
+.. automodule:: roster_config_manager.__init__
+ :members:
+ :undoc-members:
+ :show-inheritance:
+
+:mod:`config_lib` Module
+------------------------
+
+.. automodule:: roster_config_manager.config_lib
+ :members:
+ :undoc-members:
+ :show-inheritance:
+
+:mod:`db_recovery` Module
+-------------------------
+
+.. automodule:: roster_config_manager.db_recovery
+ :members:
+ :undoc-members:
+ :show-inheritance:
+
+:mod:`dns_query_lib` Module
+---------------------------
+
+.. automodule:: roster_config_manager.dns_query_lib
+ :members:
+ :undoc-members:
+ :show-inheritance:
+
+:mod:`tree_exporter` Module
+---------------------------
+
+.. automodule:: roster_config_manager.tree_exporter
+ :members:
+ :undoc-members:
+ :show-inheritance:
+
+:mod:`zone_exporter_lib` Module
+-------------------------------
+
+.. automodule:: roster_config_manager.zone_exporter_lib
+ :members:
+ :undoc-members:
+ :show-inheritance:
+
+:mod:`zone_importer_lib` Module
+-------------------------------
+
+.. automodule:: roster_config_manager.zone_importer_lib
+ :members:
+ :undoc-members:
+ :show-inheritance:
+
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_static/ajax-loader.gif
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,32 @@
+GIF89a ò ÿÿÿ U|ÆÖßN U|l (R) << 3/4 ¶Æ!þ Created with
ajaxload.info !ù
+ !ÿ
+NETSCAPE2.0 , 3 ºÜþ0ÊIk c : N f E±1º Á¶.`ÄÂqÐ-[ 9Ý| 9
+ JkçH !ù
+ , 4 ºÜþN !
+>>°æ DqBQT`1 `LE[ ¨|
+µußía × â C ²%$* !ù
+ , 6 º2#+ÊAÈ Ì V/
+c
+ ô NñIBa <<p
+ð
+̳ 1/2
+ƨ+ Yí ü à 2(c)d ¿ !ù
+ , 3 ºb%+Ê2 ì V_
+ |
+!
+ 1D a
+ ªF °Ñ bR]ó= 08, Ȥr9L !ù
+ , 2 ºr'+Jçd ð óL
+&vÃ`\bT
+ ¹
+hYB)ÏÊ@
+é< Ã&, ȤR !ù
+ , 3 º Â 9 ãtç 1/4 Ú 0 Ç
+à!.B¶ ÊW¬¢1
+
+ sa>>°5÷ 0° >> m)J !ù
+ , 2 ºÜþð Ù U] îÚqp ` Ýa Ý4
+AFÅ0 ` ¶
+ Â@ 1 ÂÖÎ !ù
+ , 2 ºÜþ0ÊI<<eBÔ )×
+ à Çq 10(c)ʰ(R)P Âa VÚ¥ ub [ ;
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/_static/basic.css
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,540 @@
+/*
+ * basic.css
+ * ~~~~~~~~~
+ *
+ * Sphinx stylesheet -- basic theme.
+ *
+ * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+/* -- main layout
----------------------------------------------------------- */
+
+div.clearer {
+ clear: both;
+}
+
+/* -- relbar
---------------------------------------------------------------- */
+
+div.related {
+ width: 100%;
+ font-size: 90%;
+}
+
+div.related h3 {
+ display: none;
+}
+
+div.related ul {
+ margin: 0;
+ padding: 0 0 0 10px;
+ list-style: none;
+}
+
+div.related li {
+ display: inline;
+}
+
+div.related li.right {
+ float: right;
+ margin-right: 5px;
+}
+
+/* -- sidebar
--------------------------------------------------------------- */
+
+div.sphinxsidebarwrapper {
+ padding: 10px 5px 0 10px;
+}
+
+div.sphinxsidebar {
+ float: left;
+ width: 230px;
+ margin-left: -100%;
+ font-size: 90%;
+}
+
+div.sphinxsidebar ul {
+ list-style: none;
+}
+
+div.sphinxsidebar ul ul,
+div.sphinxsidebar ul.want-points {
+ margin-left: 20px;
+ list-style: square;
+}
+
+div.sphinxsidebar ul ul {
+ margin-top: 0;
+ margin-bottom: 0;
+}
+
+div.sphinxsidebar form {
+ margin-top: 10px;
+}
+
+div.sphinxsidebar input {
+ border: 1px solid #98dbcc;
+ font-family: sans-serif;
+ font-size: 1em;
+}
+
+div.sphinxsidebar #searchbox input[type="text"] {
+ width: 170px;
+}
+
+div.sphinxsidebar #searchbox input[type="submit"] {
+ width: 30px;
+}
+
+img {
+ border: 0;
+}
+
+/* -- search page
----------------------------------------------------------- */
+
+ul.search {
+ margin: 10px 0 0 20px;
+ padding: 0;
+}
+
+ul.search li {
+ padding: 5px 0 5px 20px;
+ background-image: url(file.png);
+ background-repeat: no-repeat;
+ background-position: 0 7px;
+}
+
+ul.search li a {
+ font-weight: bold;
+}
+
+ul.search li div.context {
+ color: #888;
+ margin: 2px 0 0 30px;
+ text-align: left;
+}
+
+ul.keywordmatches li.goodmatch a {
+ font-weight: bold;
+}
+
+/* -- index page
------------------------------------------------------------ */
+
+table.contentstable {
+ width: 90%;
+}
+
+table.contentstable p.biglink {
+ line-height: 150%;
+}
+
+a.biglink {
+ font-size: 1.3em;
+}
+
+span.linkdescr {
+ font-style: italic;
+ padding-top: 5px;
+ font-size: 90%;
+}
+
+/* -- general index
--------------------------------------------------------- */
+
+table.indextable {
+ width: 100%;
+}
+
+table.indextable td {
+ text-align: left;
+ vertical-align: top;
+}
+
+table.indextable dl, table.indextable dd {
+ margin-top: 0;
+ margin-bottom: 0;
+}
+
+table.indextable tr.pcap {
+ height: 10px;
+}
+
+table.indextable tr.cap {
+ margin-top: 10px;
+ background-color: #f2f2f2;
+}
+
+img.toggler {
+ margin-right: 3px;
+ margin-top: 3px;
+ cursor: pointer;
+}
+
+div.modindex-jumpbox {
+ border-top: 1px solid #ddd;
+ border-bottom: 1px solid #ddd;
+ margin: 1em 0 1em 0;
+ padding: 0.4em;
+}
+
+div.genindex-jumpbox {
+ border-top: 1px solid #ddd;
+ border-bottom: 1px solid #ddd;
+ margin: 1em 0 1em 0;
+ padding: 0.4em;
+}
+
+/* -- general body styles
--------------------------------------------------- */
+
+a.headerlink {
+ visibility: hidden;
+}
+
+h1:hover > a.headerlink,
+h2:hover > a.headerlink,
+h3:hover > a.headerlink,
+h4:hover > a.headerlink,
+h5:hover > a.headerlink,
+h6:hover > a.headerlink,
+dt:hover > a.headerlink {
+ visibility: visible;
+}
+
+div.body p.caption {
+ text-align: inherit;
+}
+
+div.body td {
+ text-align: left;
+}
+
+.field-list ul {
+ padding-left: 1em;
+}
+
+.first {
+ margin-top: 0 !important;
+}
+
+p.rubric {
+ margin-top: 30px;
+ font-weight: bold;
+}
+
+img.align-left, .figure.align-left, object.align-left {
+ clear: left;
+ float: left;
+ margin-right: 1em;
+}
+
+img.align-right, .figure.align-right, object.align-right {
+ clear: right;
+ float: right;
+ margin-left: 1em;
+}
+
+img.align-center, .figure.align-center, object.align-center {
+ display: block;
+ margin-left: auto;
+ margin-right: auto;
+}
+
+.align-left {
+ text-align: left;
+}
+
+.align-center {
+ text-align: center;
+}
+
+.align-right {
+ text-align: right;
+}
+
+/* -- sidebars
-------------------------------------------------------------- */
+
+div.sidebar {
+ margin: 0 0 0.5em 1em;
+ border: 1px solid #ddb;
+ padding: 7px 7px 0 7px;
+ background-color: #ffe;
+ width: 40%;
+ float: right;
+}
+
+p.sidebar-title {
+ font-weight: bold;
+}
+
+/* -- topics
---------------------------------------------------------------- */
+
+div.topic {
+ border: 1px solid #ccc;
+ padding: 7px 7px 0 7px;
+ margin: 10px 0 10px 0;
+}
+
+p.topic-title {
+ font-size: 1.1em;
+ font-weight: bold;
+ margin-top: 10px;
+}
+
+/* -- admonitions
----------------------------------------------------------- */
+
+div.admonition {
+ margin-top: 10px;
+ margin-bottom: 10px;
+ padding: 7px;
+}
+
+div.admonition dt {
+ font-weight: bold;
+}
+
+div.admonition dl {
+ margin-bottom: 0;
+}
+
+p.admonition-title {
+ margin: 0px 10px 5px 0px;
+ font-weight: bold;
+}
+
+div.body p.centered {
+ text-align: center;
+ margin-top: 25px;
+}
+
+/* -- tables
---------------------------------------------------------------- */
+
+table.docutils {
+ border: 0;
+ border-collapse: collapse;
+}
+
+table.docutils td, table.docutils th {
+ padding: 1px 8px 1px 5px;
+ border-top: 0;
+ border-left: 0;
+ border-right: 0;
+ border-bottom: 1px solid #aaa;
+}
+
+table.field-list td, table.field-list th {
+ border: 0 !important;
+}
+
+table.footnote td, table.footnote th {
+ border: 0 !important;
+}
+
+th {
+ text-align: left;
+ padding-right: 5px;
+}
+
+table.citation {
+ border-left: solid 1px gray;
+ margin-left: 1px;
+}
+
+table.citation td {
+ border-bottom: none;
+}
+
+/* -- other body styles
----------------------------------------------------- */
+
+ol.arabic {
+ list-style: decimal;
+}
+
+ol.loweralpha {
+ list-style: lower-alpha;
+}
+
+ol.upperalpha {
+ list-style: upper-alpha;
+}
+
+ol.lowerroman {
+ list-style: lower-roman;
+}
+
+ol.upperroman {
+ list-style: upper-roman;
+}
+
+dl {
+ margin-bottom: 15px;
+}
+
+dd p {
+ margin-top: 0px;
+}
+
+dd ul, dd table {
+ margin-bottom: 10px;
+}
+
+dd {
+ margin-top: 3px;
+ margin-bottom: 10px;
+ margin-left: 30px;
+}
+
+dt:target, .highlighted {
+ background-color: #fbe54e;
+}
+
+dl.glossary dt {
+ font-weight: bold;
+ font-size: 1.1em;
+}
+
+.field-list ul {
+ margin: 0;
+ padding-left: 1em;
+}
+
+.field-list p {
+ margin: 0;
+}
+
+.refcount {
+ color: #060;
+}
+
+.optional {
+ font-size: 1.3em;
+}
+
+.versionmodified {
+ font-style: italic;
+}
+
+.system-message {
+ background-color: #fda;
+ padding: 5px;
+ border: 3px solid red;
+}
+
+.footnote:target {
+ background-color: #ffa;
+}
+
+.line-block {
+ display: block;
+ margin-top: 1em;
+ margin-bottom: 1em;
+}
+
+.line-block .line-block {
+ margin-top: 0;
+ margin-bottom: 0;
+ margin-left: 1.5em;
+}
+
+.guilabel, .menuselection {
+ font-family: sans-serif;
+}
+
+.accelerator {
+ text-decoration: underline;
+}
+
+.classifier {
+ font-style: oblique;
+}
+
+abbr, acronym {
+ border-bottom: dotted 1px;
+ cursor: help;
+}
+
+/* -- code displays
--------------------------------------------------------- */
+
+pre {
+ overflow: auto;
+ overflow-y: hidden; /* fixes display issues on Chrome browsers */
+}
+
+td.linenos pre {
+ padding: 5px 0px;
+ border: 0;
+ background-color: transparent;
+ color: #aaa;
+}
+
+table.highlighttable {
+ margin-left: 0.5em;
+}
+
+table.highlighttable td {
+ padding: 0 0.5em 0 0.5em;
+}
+
+tt.descname {
+ background-color: transparent;
+ font-weight: bold;
+ font-size: 1.2em;
+}
+
+tt.descclassname {
+ background-color: transparent;
+}
+
+tt.xref, a tt {
+ background-color: transparent;
+ font-weight: bold;
+}
+
+h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt {
+ background-color: transparent;
+}
+
+.viewcode-link {
+ float: right;
+}
+
+.viewcode-back {
+ float: right;
+ font-family: sans-serif;
+}
+
+div.viewcode-block:target {
+ margin: -1px -10px;
+ padding: 0 10px;
+}
+
+/* -- math display
---------------------------------------------------------- */
+
+img.math {
+ vertical-align: middle;
+}
+
+div.body div.math p {
+ text-align: center;
+}
+
+span.eqno {
+ float: right;
+}
+
+/* -- printout stylesheet
--------------------------------------------------- */
+
+@media print {
+ div.document,
+ div.documentwrapper,
+ div.bodywrapper {
+ margin: 0 !important;
+ width: 100%;
+ }
+
+ div.sphinxsidebar,
+ div.related,
+ div.footer,
+ #top-link {
+ display: none;
+ }
+}
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_static/comment-bright.png
Mon Aug 19 17:06:11 2013 UTC
Binary file, no diff available.
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_static/comment-close.png
Mon Aug 19 17:06:11 2013 UTC
Binary file, no diff available.
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/_static/comment.png
Mon Aug 19 17:06:11 2013 UTC
Binary file, no diff available.
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/_static/default.css
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,256 @@
+/*
+ * default.css_t
+ * ~~~~~~~~~~~~~
+ *
+ * Sphinx stylesheet -- default theme.
+ *
+ * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+@import url("basic.css");
+
+/* -- page layout
----------------------------------------------------------- */
+
+body {
+ font-family: sans-serif;
+ font-size: 100%;
+ background-color: #11303d;
+ color: #000;
+ margin: 0;
+ padding: 0;
+}
+
+div.document {
+ background-color: #1c4e63;
+}
+
+div.documentwrapper {
+ float: left;
+ width: 100%;
+}
+
+div.bodywrapper {
+ margin: 0 0 0 230px;
+}
+
+div.body {
+ background-color: #ffffff;
+ color: #000000;
+ padding: 0 20px 30px 20px;
+}
+
+div.footer {
+ color: #ffffff;
+ width: 100%;
+ padding: 9px 0 9px 0;
+ text-align: center;
+ font-size: 75%;
+}
+
+div.footer a {
+ color: #ffffff;
+ text-decoration: underline;
+}
+
+div.related {
+ background-color: #133f52;
+ line-height: 30px;
+ color: #ffffff;
+}
+
+div.related a {
+ color: #ffffff;
+}
+
+div.sphinxsidebar {
+}
+
+div.sphinxsidebar h3 {
+ font-family: 'Trebuchet MS', sans-serif;
+ color: #ffffff;
+ font-size: 1.4em;
+ font-weight: normal;
+ margin: 0;
+ padding: 0;
+}
+
+div.sphinxsidebar h3 a {
+ color: #ffffff;
+}
+
+div.sphinxsidebar h4 {
+ font-family: 'Trebuchet MS', sans-serif;
+ color: #ffffff;
+ font-size: 1.3em;
+ font-weight: normal;
+ margin: 5px 0 0 0;
+ padding: 0;
+}
+
+div.sphinxsidebar p {
+ color: #ffffff;
+}
+
+div.sphinxsidebar p.topless {
+ margin: 5px 10px 10px 10px;
+}
+
+div.sphinxsidebar ul {
+ margin: 10px;
+ padding: 0;
+ color: #ffffff;
+}
+
+div.sphinxsidebar a {
+ color: #98dbcc;
+}
+
+div.sphinxsidebar input {
+ border: 1px solid #98dbcc;
+ font-family: sans-serif;
+ font-size: 1em;
+}
+
+
+
+/* -- hyperlink styles
------------------------------------------------------ */
+
+a {
+ color: #355f7c;
+ text-decoration: none;
+}
+
+a:visited {
+ color: #355f7c;
+ text-decoration: none;
+}
+
+a:hover {
+ text-decoration: underline;
+}
+
+
+
+/* -- body styles
----------------------------------------------------------- */
+
+div.body h1,
+div.body h2,
+div.body h3,
+div.body h4,
+div.body h5,
+div.body h6 {
+ font-family: 'Trebuchet MS', sans-serif;
+ background-color: #f2f2f2;
+ font-weight: normal;
+ color: #20435c;
+ border-bottom: 1px solid #ccc;
+ margin: 20px -20px 10px -20px;
+ padding: 3px 0 3px 10px;
+}
+
+div.body h1 { margin-top: 0; font-size: 200%; }
+div.body h2 { font-size: 160%; }
+div.body h3 { font-size: 140%; }
+div.body h4 { font-size: 120%; }
+div.body h5 { font-size: 110%; }
+div.body h6 { font-size: 100%; }
+
+a.headerlink {
+ color: #c60f0f;
+ font-size: 0.8em;
+ padding: 0 4px 0 4px;
+ text-decoration: none;
+}
+
+a.headerlink:hover {
+ background-color: #c60f0f;
+ color: white;
+}
+
+div.body p, div.body dd, div.body li {
+ text-align: justify;
+ line-height: 130%;
+}
+
+div.admonition p.admonition-title + p {
+ display: inline;
+}
+
+div.admonition p {
+ margin-bottom: 5px;
+}
+
+div.admonition pre {
+ margin-bottom: 5px;
+}
+
+div.admonition ul, div.admonition ol {
+ margin-bottom: 5px;
+}
+
+div.note {
+ background-color: #eee;
+ border: 1px solid #ccc;
+}
+
+div.seealso {
+ background-color: #ffc;
+ border: 1px solid #ff6;
+}
+
+div.topic {
+ background-color: #eee;
+}
+
+div.warning {
+ background-color: #ffe4e4;
+ border: 1px solid #f66;
+}
+
+p.admonition-title {
+ display: inline;
+}
+
+p.admonition-title:after {
+ content: ":";
+}
+
+pre {
+ padding: 5px;
+ background-color: #eeffcc;
+ color: #333333;
+ line-height: 120%;
+ border: 1px solid #ac9;
+ border-left: none;
+ border-right: none;
+}
+
+tt {
+ background-color: #ecf0f3;
+ padding: 0 1px 0 1px;
+ font-size: 0.95em;
+}
+
+th {
+ background-color: #ede;
+}
+
+.warning tt {
+ background: #efc2c2;
+}
+
+.note tt {
+ background: #d6d6d6;
+}
+
+.viewcode-back {
+ font-family: sans-serif;
+}
+
+div.viewcode-block:target {
+ background-color: #f4debf;
+ border-top: 1px solid #ac9;
+ border-bottom: 1px solid #ac9;
+}
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/_static/doctools.js
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,235 @@
+/*
+ * doctools.js
+ * ~~~~~~~~~~~
+ *
+ * Sphinx JavaScript utilities for all documentation.
+ *
+ * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+/**
+ * select a different prefix for underscore
+ */
+$u = _.noConflict();
+
+/**
+ * make the code below compatible with browsers without
+ * an installed firebug like debugger
+if (!window.console || !console.firebug) {
+ var names = ["log", "debug", "info", "warn", "error", "assert", "dir",
+ "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace",
+ "profile", "profileEnd"];
+ window.console = {};
+ for (var i = 0; i < names.length; ++i)
+ window.console[names[i]] = function() {};
+}
+ */
+
+/**
+ * small helper function to urldecode strings
+ */
+jQuery.urldecode = function(x) {
+ return decodeURIComponent(x).replace(/\+/g, ' ');
+};
+
+/**
+ * small helper function to urlencode strings
+ */
+jQuery.urlencode = encodeURIComponent;
+
+/**
+ * This function returns the parsed url parameters of the
+ * current request. Multiple values per key are supported,
+ * it will always return arrays of strings for the value parts.
+ */
+jQuery.getQueryParameters = function(s) {
+ if (typeof s == 'undefined')
+ s = document.location.search;
+ var parts = s.substr(s.indexOf('?') + 1).split('&');
+ var result = {};
+ for (var i = 0; i < parts.length; i++) {
+ var tmp = parts[i].split('=', 2);
+ var key = jQuery.urldecode(tmp[0]);
+ var value = jQuery.urldecode(tmp[1]);
+ if (key in result)
+ result[key].push(value);
+ else
+ result[key] = [value];
+ }
+ return result;
+};
+
+/**
+ * highlight a given string on a jquery object by wrapping it in
+ * span elements with the given class name.
+ */
+jQuery.fn.highlightText = function(text, className) {
+ function highlight(node) {
+ if (node.nodeType == 3) {
+ var val = node.nodeValue;
+ var pos = val.toLowerCase().indexOf(text);
+ if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) {
+ var span = document.createElement("span");
+ span.className = className;
+ span.appendChild(document.createTextNode(val.substr(pos,
text.length)));
+ node.parentNode.insertBefore(span, node.parentNode.insertBefore(
+ document.createTextNode(val.substr(pos + text.length)),
+ node.nextSibling));
+ node.nodeValue = val.substr(0, pos);
+ }
+ }
+ else if (!jQuery(node).is("button, select, textarea")) {
+ jQuery.each(node.childNodes, function() {
+ highlight(this);
+ });
+ }
+ }
+ return this.each(function() {
+ highlight(this);
+ });
+};
+
+/**
+ * Small JavaScript module for the documentation.
+ */
+var Documentation = {
+
+ init : function() {
+ this.fixFirefoxAnchorBug();
+ this.highlightSearchWords();
+ this.initIndexTable();
+ },
+
+ /**
+ * i18n support
+ */
+ TRANSLATIONS : {},
+ PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; },
+ LOCALE : 'unknown',
+
+ // gettext and ngettext don't access this so that the functions
+ // can safely bound to a different name (_ = Documentation.gettext)
+ gettext : function(string) {
+ var translated = Documentation.TRANSLATIONS[string];
+ if (typeof translated == 'undefined')
+ return string;
+ return (typeof translated == 'string') ? translated : translated[0];
+ },
+
+ ngettext : function(singular, plural, n) {
+ var translated = Documentation.TRANSLATIONS[singular];
+ if (typeof translated == 'undefined')
+ return (n == 1) ? singular : plural;
+ return translated[Documentation.PLURALEXPR(n)];
+ },
+
+ addTranslations : function(catalog) {
+ for (var key in catalog.messages)
+ this.TRANSLATIONS[key] = catalog.messages[key];
+ this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr
+ ')');
+ this.LOCALE = catalog.locale;
+ },
+
+ /**
+ * add context elements like header anchor links
+ */
+ addContextElements : function() {
+ $('div[id] > :header:first').each(function() {
+ $('<a class="headerlink">\u00B6</a>').
+ attr('href', '#' +
this.id).
+ attr('title', _('Permalink to this headline')).
+ appendTo(this);
+ });
+ $('dt[id]').each(function() {
+ $('<a class="headerlink">\u00B6</a>').
+ attr('href', '#' +
this.id).
+ attr('title', _('Permalink to this definition')).
+ appendTo(this);
+ });
+ },
+
+ /**
+ * workaround a firefox stupidity
+ */
+ fixFirefoxAnchorBug : function() {
+ if (document.location.hash && $.browser.mozilla)
+ window.setTimeout(function() {
+ document.location.href += '';
+ }, 10);
+ },
+
+ /**
+ * highlight the search words provided in the url in the text
+ */
+ highlightSearchWords : function() {
+ var params = $.getQueryParameters();
+ var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : [];
+ if (terms.length) {
+ var body = $('div.body');
+ window.setTimeout(function() {
+ $.each(terms, function() {
+ body.highlightText(this.toLowerCase(), 'highlighted');
+ });
+ }, 10);
+ $('<p class="highlight-link"><a href="javascript:Documentation.' +
+ 'hideSearchWords()">' + _('Hide Search Matches') + '</a></p>')
+ .appendTo($('#searchbox'));
+ }
+ },
+
+ /**
+ * init the domain index toggle buttons
+ */
+ initIndexTable : function() {
+ var togglers = $('img.toggler').click(function() {
+ var src = $(this).attr('src');
+ var idnum = $(this).attr('id').substr(7);
+ $('tr.cg-' + idnum).toggle();
+ if (src.substr(-9) == 'minus.png')
+ $(this).attr('src', src.substr(0, src.length-9) + 'plus.png');
+ else
+ $(this).attr('src', src.substr(0, src.length-8) + 'minus.png');
+ }).css('display', '');
+ if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) {
+ togglers.click();
+ }
+ },
+
+ /**
+ * helper function to hide the search marks again
+ */
+ hideSearchWords : function() {
+ $('#searchbox .highlight-link').fadeOut(300);
+ $('span.highlighted').removeClass('highlighted');
+ },
+
+ /**
+ * make the url absolute
+ */
+ makeURL : function(relativeURL) {
+ return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL;
+ },
+
+ /**
+ * get the current relative url
+ */
+ getCurrentURL : function() {
+ var path = document.location.pathname;
+ var parts = path.split(/\//);
+ $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() {
+ if (this == '..')
+ parts.pop();
+ });
+ var url = parts.join('/');
+ return path.substring(url.lastIndexOf('/') + 1, path.length - 1);
+ }
+};
+
+// quick alias for translations
+_ = Documentation.gettext;
+
+$(document).ready(function() {
+ Documentation.init();
+});
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_static/down-pressed.png
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,18 @@
+ PNG
+
+
+IHDR óÿa sRGB (R)Î
+é bKGD ùC>> pHYs
+×
+× B( x tIME Ú
+ - v F# ðIDAT8ËÍÒ!O A àïÚJ, ++@ I
+v
+¢bÿ@Wñ7F HNâ± ú# 4¡ 8Ì6¹4×6Tñ MvvÞ 1/4 7³>>ê ûöD s¿ a óx â1 U îq ;<| Ï
+E ¸Â-f)âºj%ßp o4xFà 78G
+>æ)â -
+¡ÂEYm4%7Y
+Tk-3/4 Q¶a "NWAo-y eqÒá 3/4,
+ )â
+ÓÒYÓÑú´pt Ð å 1/2\h ó q´Îím sÔz |ìG]ÄN ñ Òa
+ röçß¶¨s^lã
+vh\î2Ù%ðâßã 0EeR vØ IEND(R)B`
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/_static/down.png Mon
Aug 19 17:06:11 2013 UTC
Binary file, no diff available.
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/_static/file.png Mon
Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,18 @@
+ PNG
+
+
+IHDR óÿa bKGD ÿ ÿ ÿ 1/2 § pHYs
+
+ tIME Õ
+
+ )¶T
+ IDAT8Ë- ±JÄ@ ¿Ir(' [
+"&
+xØÙYZ Xø0 !i| _@±Ô÷ t§ ÓDÄæ Ï]
+¹#¹Äx ÿjv ùç
+
+ Y
+ÐN a E i<<( ÌÄÉ y £µ @D|£&± `Û6(R)ë P| Zk $)5 %"ôz 1/2 Ê.Nñ A#A ba `Vs ø 3/4_3ñ
+c °,<< àä2m 1/4 Ýñþjó
+ [k ìlv¹y|!IÕ´ðþyô; ÀðvÈé " ß(R) ° a(c)? AúðÄ7 `ô ñÇ c^énôk?¸²Bg}>>TÐ ¹D#ÁÑÞ
+"R¹D1÷£ çyüE Rê* ãÝ6MJ(c)3þK_U<<t 8F~Ç IEND(R)B`
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/_static/jquery.js
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,4 @@
+/*! jQuery v1.7.1
jquery.com |
jquery.org/license */
+(function(a,b){function cy(a){return
f.isWindow(a)?a:a.nodeType===9?a.defaultView||a.parentWindow:!1}function
cv(a){if(!ck[a]){var
b=c.body,d=f("<"+a+">").appendTo(b),e=d.css("display");d.remove();if(e==="none"|
|e===""){cl||
(cl=c.createElement("iframe"),cl.frameBorder=cl.width=cl.height=0),b.appendChild(cl);if(!cm|
|!cl.createElement)cm=(cl.contentWindow||
cl.contentDocument).document,cm.write((c.compatMode==="CSS1Compat"?"<!doctype
html>":"")+"<html><body>"),cm.close();d=cm.createElement(a),cm.body.appendChild(d),e=f.css(d,"display"),b.removeChild(cl)}ck[a]=e}return
ck[a]}function cu(a,b){var
c={};f.each(cq.concat.apply([],cq.slice(0,b)),function(){c[this]=a});return
c}function ct(){cr=b}function cs(){setTimeout(ct,0);return
cr=f.now()}function cj(){try{return new
a.ActiveXObject("Microsoft.XMLHTTP")}catch(b){}}function ci(){try{return
new a.XMLHttpRequest}catch(b){}}function
cc(a,c){a.dataFilter&&(c=a.dataFilter(c,a.dataType));var
d=a.dataTypes,e={},g,h,i=d.length,j,k=d[0],l,m,n,o,p;for(g=1;g<i;g++){if(g===1)for(h
in a.converters)typeof
h=="string"&&(e[h.toLowerCase()]=a.converters[h]);l=k,k=d[g];if(k==="*")k=l;else
if(l!=="*"&&l!==k){m=l+" "+k,n=e[m]||e["* "+k];if(!n){p=b;for(o in
e){j=o.split(" ");if(j[0]===l||
j[0]==="*"){p=e[j[1]+" "+k];if(p){o=e[o],o===!0?n=p:p===!0&&(n=o);break}}}}!n&&!p&&f.error("No
conversion from "+m.replace(" "," to ")),n!==!0&&(c=n?n(c):p(o(c)))}}return
c}function cb(a,c,d){var
e=a.contents,f=a.dataTypes,g=a.responseFields,h,i,j,k;for(i in g)i in
d&&(c[g[i]]=d[i]);while(f[0]==="*")f.shift(),h===b&&(h=a.mimeType||
c.getResponseHeader("content-type"));if(h)for(i in
e)if(e[i]&&e[i].test(h)){f.unshift(i);break}if(f[0]in d)j=f[0];else{for(i
in d){if(!f[0]||a.converters[i+" "+f[0]]){j=i;break}k||(k=i)}j=j||
k}if(j){j!==f[0]&&f.unshift(j);return d[j]}}function
ca(a,b,c,d){if(f.isArray(b))f.each(b,function(b,e){c||
bE.test(a)?d(a,e):ca(a+"["+(typeof e=="object"||
f.isArray(e)?b:"")+"]",e,c,d)});else if(!c&&b!=null&&typeof
b=="object")for(var e in b)ca(a+"["+e+"]",b[e],c,d);else d(a,b)}function
b_(a,c){var d,e,g=f.ajaxSettings.flatOptions||{};for(d in
c)c[d]!==b&&((g[d]?a:e||(e={}))[d]=c[d]);e&&f.extend(!0,a,e)}function
b$(a,c,d,e,f,g){f=f||c.dataTypes[0],g=g||{},g[f]=!0;var
h=a[f],i=0,j=h?h.length:0,k=a===bT,l;for(;i<j&&(k|
|!l);i++)l=h[i](c,d,e),typeof l=="string"&&(!k||
g[l]?l=b:(c.dataTypes.unshift(l),l=b$(a,c,d,e,l,g)));(k|
|!l)&&!g["*"]&&(l=b$(a,c,d,e,"*",g));return l}function bZ(a){return
function(b,c){typeof b!="string"&&(c=b,b="*");if(f.isFunction(c)){var
d=b.toLowerCase().split(bP),e=0,g=d.length,h,i,j;for(;e<g;e++)h=d[e],j=/^\+/.test(h),j&&(h=h.substr(1)|
|"*"),i=a[h]=a[h]||[],i[j?"unshift":"push"](c)}}}function bC(a,b,c){var
d=b==="width"?a.offsetWidth:a.offsetHeight,e=b==="width"?bx:by,g=0,h=e.length;if(d>0){if(c!=="border")for(;g<h;g++)c|
|(d-=parseFloat(f.css(a,"padding"+e[g]))||
0),c==="margin"?d+=parseFloat(f.css(a,c+e[g]))||
0:d-=parseFloat(f.css(a,"border"+e[g]+"Width"))||0;return
d+"px"}d=bz(a,b,b);if(d<0||d==null)d=a.style[b]||0;d=parseFloat(d)||
0;if(c)for(;g<h;g++)d+=parseFloat(f.css(a,"padding"+e[g]))||
0,c!=="padding"&&(d+=parseFloat(f.css(a,"border"+e[g]+"Width"))||
0),c==="margin"&&(d+=parseFloat(f.css(a,c+e[g]))||0);return d+"px"}function
bp(a,b){b.src?f.ajax({url:b.src,async:!1,dataType:"script"}):f.globalEval((b.text|
|b.textContent||b.innerHTML|
|"").replace(bf,"/*$0*/")),b.parentNode&&b.parentNode.removeChild(b)}function
bo(a){var
b=c.createElement("div");bh.appendChild(b),b.innerHTML=a.outerHTML;return
b.firstChild}function bn(a){var b=(a.nodeName|
|"").toLowerCase();b==="input"?bm(a):b!=="script"&&typeof
a.getElementsByTagName!="undefined"&&f.grep(a.getElementsByTagName("input"),bm)}function
bm(a){if(a.type==="checkbox"||
a.type==="radio")a.defaultChecked=a.checked}function bl(a){return typeof
a.getElementsByTagName!="undefined"?a.getElementsByTagName("*"):typeof
a.querySelectorAll!="undefined"?a.querySelectorAll("*"):[]}function
bk(a,b){var
c;if(b.nodeType===1){b.clearAttributes&&b.clearAttributes(),b.mergeAttributes&&b.mergeAttributes(a),c=b.nodeName.toLowerCase();if(c==="object")b.outerHTML=a.outerHTML;else
if(c!=="input"||
a.type!=="checkbox"&&a.type!=="radio"){if(c==="option")b.selected=a.defaultSelected;else
if(c==="input"||c==="textarea")b.defaultValue=a.defaultValue}else
a.checked&&(b.defaultChecked=b.checked=a.checked),b.value!==a.value&&(b.value=a.value);b.removeAttribute(f.expando)}}function
bj(a,b){if(b.nodeType===1&&!!f.hasData(a)){var
c,d,e,g=f._data(a),h=f._data(b,g),i=g.events;if(i){delete
h.handle,h.events={};for(c in
i)for(d=0,e=i[c].length;d<e;d++)f.event.add(b,c+(i[c][d].namespace?".":"")+i[c][d].namespace,i[c][d],i[c][d].data)}h.data&&(h.data=f.extend({},h.data))}}function
bi(a,b){return f.nodeName(a,"table")?a.getElementsByTagName("tbody")[0]||
a.appendChild(a.ownerDocument.createElement("tbody")):a}function U(a){var
b=V.split("|"),c=a.createDocumentFragment();if(c.createElement)while(b.length)c.createElement(b.pop());return
c}function T(a,b,c){b=b||0;if(f.isFunction(b))return
f.grep(a,function(a,d){var e=!!b.call(a,d,a);return
e===c});if(b.nodeType)return f.grep(a,function(a,d){return
a===b===c});if(typeof b=="string"){var d=f.grep(a,function(a){return
a.nodeType===1});if(O.test(b))return
f.filter(b,d,!c);b=f.filter(b,d)}return f.grep(a,function(a,d){return
f.inArray(a,b)>=0===c})}function S(a){return!a||!a.parentNode||
a.parentNode.nodeType===11}function K(){return!0}function
J(){return!1}function n(a,b,c){var
d=b+"defer",e=b+"queue",g=b+"mark",h=f._data(a,d);h&&(c==="queue"|
|!f._data(a,e))&&(c==="mark"|
|!f._data(a,g))&&setTimeout(function(){!f._data(a,e)&&!f._data(a,g)&&(f.removeData(a,d,!0),h.fire())},0)}function
m(a){for(var b in
a){if(b==="data"&&f.isEmptyObject(a[b]))continue;if(b!=="toJSON")return!1}return!0}function
l(a,c,d){if(d===b&&a.nodeType===1){var
e="data-"+c.replace(k,"-$1").toLowerCase();d=a.getAttribute(e);if(typeof
d=="string"){try{d=d==="true"?!0:d==="false"?!1:d==="null"?null:f.isNumeric(d)?parseFloat(d):j.test(d)?f.parseJSON(d):d}catch(g){}f.data(a,c,d)}else
d=b}return d}function h(a){var
b=g[a]={},c,d;a=a.split(/\s+/);for(c=0,d=a.length;c<d;c++)b[a[c]]=!0;return
b}var c=a.document,d=a.navigator,e=a.location,f=function(){function
J(){if(!e.isReady){try{c.documentElement.doScroll("left")}catch(a){setTimeout(J,1);return}e.ready()}}var
e=function(a,b){return new
e.fn.init(a,b,h)},f=a.jQuery,g=a.$,h,i=/^(?:[^#<]*(<[\w\W]+>)[^>]*$|
#([\w\-]*)$)/,j=/\S/,k=/^\s+/,l=/\s+$/,m=/^<(\w+)\s*\/?>(?:<\/\1>)?$/,n=/^[\],:{}\s]*$/,o=/\\(?:["\\\/bfnrt]|
u[0-9a-fA-F]{4})/g,p=/"[^"\\\n\r]*"|true|false|null|
-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g,q=/(?:^|:|,)(?:\s*\[)+/g,r=/(webkit)[
\/]([\w.]+)/,s=/(opera)(?:.*version)?[ \/]([\w.]+)/,t=/(msie)
([\w.]+)/,u=/(mozilla)(?:.*? rv:([\w.]+))?/,v=/-([a-z]|
[0-9])/ig,w=/^-ms-/,x=function(a,b){return(b+"").toUpperCase()},y=d.userAgent,z,A,B,C=Object.prototype.toString,D=Object.prototype.hasOwnProperty,E=Array.prototype.push,F=Array.prototype.slice,G=String.prototype.trim,H=Array.prototype.indexOf,I={};e.fn=e.prototype={constructor:e,init:function(a,d,f){var
g,h,j,k;if(!a)return
this;if(a.nodeType){this.context=this[0]=a,this.length=1;return
this}if(a==="body"&&!d&&c.body){this.context=c,this[0]=c.body,this.selector=a,this.length=1;return
this}if(typeof a=="string"){a.charAt(0)!=="<"||a.charAt(a.length-1)!==">"||
a.length<3?g=i.exec(a):g=[null,a,null];if(g&&(g[1]||!d)){if(g[1]){d=d
instanceof e?d[0]:d,k=d?d.ownerDocument||
d:c,j=m.exec(a),j?e.isPlainObject(d)?(a=[c.createElement(j[1])],e.fn.attr.call(a,d,!0)):a=[k.createElement(j[1])]:(j=e.buildFragment([g[1]],[k]),a=(j.cacheable?e.clone(j.fragment):j.fragment).childNodes);return
e.merge(this,a)}h=c.getElementById(g[2]);if(h&&h.parentNode){if(
h.id!==g[2])return
f.find(a);this.length=1,this[0]=h}this.context=c,this.selector=a;return
this}return!d||d.jquery?(d||
f).find(a):this.constructor(d).find(a)}if(e.isFunction(a))return
f.ready(a);a.selector!==b&&(this.selector=a.selector,this.context=a.context);return
e.makeArray(a,this)},selector:"",jquery:"1.7.1",length:0,size:function(){return
this.length},toArray:function(){return
F.call(this,0)},get:function(a){return
a==null?this.toArray():a<0?this[this.length+a]:this[a]},pushStack:function(a,b,c){var
d=this.constructor();e.isArray(a)?E.apply(d,a):e.merge(d,a),d.prevObject=this,d.context=this.context,b==="find"?d.selector=this.selector+(this.selector?" ":"")+c:b&&(d.selector=this.selector+"."+b+"("+c+")");return
d},each:function(a,b){return
e.each(this,a,b)},ready:function(a){e.bindReady(),A.add(a);return
this},eq:function(a){a=+a;return
a===-1?this.slice(a):this.slice(a,a+1)},first:function(){return
this.eq(0)},last:function(){return this.eq(-1)},slice:function(){return
this.pushStack(F.apply(this,arguments),"slice",F.call(arguments).join(","))},map:function(a){return
this.pushStack(e.map(this,function(b,c){return
a.call(b,c,b)}))},end:function(){return this.prevObject||
this.constructor(null)},push:E,sort:[].sort,splice:[].splice},e.fn.init.prototype=e.fn,e.extend=e.fn.extend=function(){var
a,c,d,f,g,h,i=arguments[0]||{},j=1,k=arguments.length,l=!1;typeof
i=="boolean"&&(l=i,i=arguments[1]||{},j=2),typeof
i!="object"&&!e.isFunction(i)&&(i={}),k===j&&(i=this,--j);for(;j<k;j++)if((a=arguments[j])!=null)for(c
in a){d=i[c],f=a[c];if(i===f)continue;l&&f&&(e.isPlainObject(f)||
(g=e.isArray(f)))?(g?(g=!1,h=d&&e.isArray(d)?d:[]):h=d&&e.isPlainObject(d)?d:{},i[c]=e.extend(l,h,f)):f!==b&&(i[c]=f)}return
i},e.extend({noConflict:function(b){a.$===e&&(a.$=g),b&&a.jQuery===e&&(a.jQuery=f);return
e},isReady:!1,readyWait:1,holdReady:function(a){a?e.readyWait++:e.ready(!0)},ready:function(a){if(a===!0&&!--e.readyWait|
|a!==!0&&!e.isReady){if(!c.body)return
setTimeout(e.ready,1);e.isReady=!0;if(a!==!0&&--e.readyWait>0)return;A.fireWith(c,[e]),e.fn.trigger&&e(c).trigger("ready").off("ready")}},bindReady:function(){if(!A){A=e.Callbacks("once
memory");if(c.readyState==="complete")return
setTimeout(e.ready,1);if(c.addEventListener)c.addEventListener("DOMContentLoaded",B,!1),a.addEventListener("load",e.ready,!1);else
if(c.attachEvent){c.attachEvent("onreadystatechange",B),a.attachEvent("onload",e.ready);var
b=!1;try{b=a.frameElement==null}catch(d){}c.documentElement.doScroll&&b&&J()}}},isFunction:function(a){return
e.type(a)==="function"},isArray:Array.isArray||function(a){return
e.type(a)==="array"},isWindow:function(a){return a&&typeof
a=="object"&&"setInterval"in
a},isNumeric:function(a){return!isNaN(parseFloat(a))&&isFinite(a)},type:function(a){return
a==null?String(a):I[C.call(a)]||"object"},isPlainObject:function(a){if(!a||
e.type(a)!=="object"||a.nodeType||
e.isWindow(a))return!1;try{if(a.constructor&&!D.call(a,"constructor")&&!D.call(a.constructor.prototype,"isPrototypeOf"))return!1}catch(c){return!1}var
d;for(d in a);return d===b||D.call(a,d)},isEmptyObject:function(a){for(var
b in a)return!1;return!0},error:function(a){throw new
Error(a)},parseJSON:function(b){if(typeof b!="string"||!b)return
null;b=e.trim(b);if(a.JSON&&a.JSON.parse)return
a.JSON.parse(b);if(n.test(b.replace(o,"@").replace(p,"]").replace(q,"")))return(new
Function("return "+b))();e.error("Invalid
JSON: "+b)},parseXML:function(c){var d,f;try{a.DOMParser?(f=new
DOMParser,d=f.parseFromString(c,"text/xml")):(d=new
ActiveXObject("Microsoft.XMLDOM"),d.async="false",d.loadXML(c))}catch(g){d=b}(!d|
|!d.documentElement||
d.getElementsByTagName("parsererror").length)&&e.error("Invalid
XML: "+c);return
d},noop:function(){},globalEval:function(b){b&&j.test(b)&&(a.execScript||
function(b){a.eval.call(a,b)})(b)},camelCase:function(a){return
a.replace(w,"ms-").replace(v,x)},nodeName:function(a,b){return
a.nodeName&&a.nodeName.toUpperCase()===b.toUpperCase()},each:function(a,c,d){var
f,g=0,h=a.length,i=h===b||e.isFunction(a);if(d){if(i){for(f in
a)if(c.apply(a[f],d)===!1)break}else
for(;g<h;)if(c.apply(a[g++],d)===!1)break}else if(i){for(f in
a)if(c.call(a[f],f,a[f])===!1)break}else
for(;g<h;)if(c.call(a[g],g,a[g++])===!1)break;return
a},trim:G?function(a){return a==null?"":G.call(a)}:function(a){return
a==null?"":(a+"").replace(k,"").replace(l,"")},makeArray:function(a,b){var
c=b||[];if(a!=null){var d=e.type(a);a.length==null||d==="string"||
d==="function"||d==="regexp"||e.isWindow(a)?E.call(c,a):e.merge(c,a)}return
c},inArray:function(a,b,c){var d;if(b){if(H)return
H.call(b,a,c);d=b.length,c=c?c<0?Math.max(0,d+c):c:0;for(;c<d;c++)if(c in
b&&b[c]===a)return c}return-1},merge:function(a,c){var
d=a.length,e=0;if(typeof c.length=="number")for(var
f=c.length;e<f;e++)a[d++]=c[e];else
while(c[e]!==b)a[d++]=c[e++];a.length=d;return a},grep:function(a,b,c){var
d=[],e;c=!!c;for(var
f=0,g=a.length;f<g;f++)e=!!b(a[f],f),c!==e&&d.push(a[f]);return
d},map:function(a,c,d){var f,g,h=[],i=0,j=a.length,k=a instanceof e||
j!==b&&typeof j=="number"&&(j>0&&a[0]&&a[j-1]||j===0||
e.isArray(a));if(k)for(;i<j;i++)f=c(a[i],i,d),f!=null&&(h[h.length]=f);else
for(g in a)f=c(a[g],g,d),f!=null&&(h[h.length]=f);return
h.concat.apply([],h)},guid:1,proxy:function(a,c){if(typeof c=="string"){var
d=a[c];c=a,a=d}if(!e.isFunction(a))return b;var
f=F.call(arguments,2),g=function(){return
a.apply(c,f.concat(F.call(arguments)))};g.guid=a.guid=a.guid||g.guid||
e.guid++;return g},access:function(a,c,d,f,g,h){var i=a.length;if(typeof
c=="object"){for(var j in c)e.access(a,j,c[j],f,g,d);return
a}if(d!==b){f=!h&&f&&e.isFunction(d);for(var
k=0;k<i;k++)g(a[k],c,f?d.call(a[k],k,g(a[k],c)):d,h);return a}return
i?g(a[0],c):b},now:function(){return(new
Date).getTime()},uaMatch:function(a){a=a.toLowerCase();var b=r.exec(a)||
s.exec(a)||t.exec(a)||a.indexOf("compatible")<0&&u.exec(a)||
[];return{browser:b[1]||"",version:b[2]||"0"}},sub:function(){function
a(b,c){return new
a.fn.init(b,c)}e.extend(!0,a,this),a.superclass=this,a.fn=a.prototype=this(),a.fn.constructor=a,a.sub=this.sub,a.fn.init=function(d,f){f&&f
instanceof e&&!(f instanceof a)&&(f=a(f));return
e.fn.init.call(this,d,f,b)},a.fn.init.prototype=a.fn;var b=a(c);return
a},browser:{}}),e.each("Boolean Number String Function Array Date RegExp
Object".split(" "),function(a,b){I["[object "+b+"]"]=b.toLowerCase()}),z=e.uaMatch(y),z.browser&&(e.browser[z.browser]=!0,e.browser.version=z.version),e.browser.webkit&&(e.browser.safari=!0),j.test(" ")&&(k=/^[\s\xA0]+/,l=/[\s\xA0]+$/),h=e(c),c.addEventListener?B=function(){c.removeEventListener("DOMContentLoaded",B,!1),e.ready()}:c.attachEvent&&(B=function(){c.readyState==="complete"&&(c.detachEvent("onreadystatechange",B),e.ready())});return
e}(),g={};f.Callbacks=function(a){a=a?g[a]||h(a):{};var
c=[],d=[],e,i,j,k,l,m=function(b){var
d,e,g,h,i;for(d=0,e=b.length;d<e;d++)g=b[d],h=f.type(g),h==="array"?m(g):h==="function"&&(!a.unique|
|!o.has(g))&&c.push(g)},n=function(b,f){f=f||[],e=!a.memory||[b,f],i=!0,l=j|
|
0,j=0,k=c.length;for(;c&&l<k;l++)if(c[l].apply(b,f)===!1&&a.stopOnFalse){e=!0;break}i=!1,c&&(a.once?e===!0?o.disable():c=[]:d&&d.length&&(e=d.shift(),o.fireWith(e[0],e[1])))},o={add:function(){if(c){var
a=c.length;m(arguments),i?k=c.length:e&&e!==!0&&(j=a,n(e[0],e[1]))}return
this},remove:function(){if(c){var
b=arguments,d=0,e=b.length;for(;d<e;d++)for(var
f=0;f<c.length;f++)if(b[d]===c[f]){i&&f<=k&&(k--,f<=l&&l--),c.splice(f--,1);if(a.unique)break}}return
this},has:function(a){if(c){var
b=0,d=c.length;for(;b<d;b++)if(a===c[b])return!0}return!1},empty:function(){c=[];return
this},disable:function(){c=d=e=b;return
this},disabled:function(){return!c},lock:function(){d=b,(!e||
e===!0)&&o.disable();return
this},locked:function(){return!d},fireWith:function(b,c){d&&(i?a.once||
d.push([b,c]):(!a.once||!e)&&n(b,c));return
this},fire:function(){o.fireWith(this,arguments);return
this},fired:function(){return!!e}};return o};var
i=[].slice;f.extend({Deferred:function(a){var b=f.Callbacks("once
memory"),c=f.Callbacks("once
memory"),d=f.Callbacks("memory"),e="pending",g={resolve:b,reject:c,notify:d},h={done:b.add,fail:c.add,progress:d.add,state:function(){return
e},isResolved:b.fired,isRejected:c.fired,then:function(a,b,c){i.done(a).fail(b).progress(c);return
this},always:function(){i.done.apply(i,arguments).fail.apply(i,arguments);return
this},pipe:function(a,b,c){return
f.Deferred(function(d){f.each({done:[a,"resolve"],fail:[b,"reject"],progress:[c,"notify"]},function(a,b){var
c=b[0],e=b[1],g;f.isFunction(c)?i[a](function(){g=c.apply(this,arguments),g&&f.isFunction(g.promise)?g.promise().then(d.resolve,d.reject,d.notify):d[e+"With"](this===i?d:this,[g])}):i[a](d[e])})}).promise()},promise:function(a){if(a==null)a=h;else
for(var b in h)a[b]=h[b];return a}},i=h.promise({}),j;for(j in
g)i[j]=g[j].fire,i[j+"With"]=g[j].fireWith;i.done(function(){e="resolved"},c.disable,d.lock).fail(function(){e="rejected"},b.disable,d.lock),a&&a.call(i,i);return
i},when:function(a){function m(a){return
function(b){e[a]=arguments.length>1?i.call(arguments,0):b,j.notifyWith(k,e)}}function
l(a){return function(c){b[a]=arguments.length>1?i.call(arguments,0):c,--g||
j.resolveWith(j,b)}}var
b=i.call(arguments,0),c=0,d=b.length,e=Array(d),g=d,h=d,j=d<=1&&a&&f.isFunction(a.promise)?a:f.Deferred(),k=j.promise();if(d>1){for(;c<d;c++)b[c]&&b[c].promise&&f.isFunction(b[c].promise)?b[c].promise().then(l(c),j.reject,m(c)):--g;g|
|j.resolveWith(j,b)}else j!==a&&j.resolveWith(j,d?[a]:[]);return
k}}),f.support=function(){var
b,d,e,g,h,i,j,k,l,m,n,o,p,q=c.createElement("div"),r=c.documentElement;q.setAttribute("className","t"),q.innerHTML="
<link/><table></table><a href='/a'
style='top:1px;float:left;opacity:.55;'>a</a><input
type='checkbox'/>",d=q.getElementsByTagName("*"),e=q.getElementsByTagName("a")[0];if(!d|
|!d.length|
|!e)return{};g=c.createElement("select"),h=g.appendChild(c.createElement("option")),i=q.getElementsByTagName("input")[0],b={leadingWhitespace:q.firstChild.nodeType===3,tbody:!q.getElementsByTagName("tbody").length,htmlSerialize:!!q.getElementsByTagName("link").length,style:/top/.test(e.getAttribute("style")),hrefNormalized:e.getAttribute("href")==="/a",opacity:/^0.55/.test(e.style.opacity),cssFloat:!!e.style.cssFloat,checkOn:i.value==="on",optSelected:h.selected,getSetAttribute:q.className!=="t",enctype:!!c.createElement("form").enctype,html5Clone:c.createElement("nav").cloneNode(!0).outerHTML!=="<:nav></:nav>",submitBubbles:!0,changeBubbles:!0,focusinBubbles:!1,deleteExpando:!0,noCloneEvent:!0,inlineBlockNeedsLayout:!1,shrinkWrapBlocks:!1,reliableMarginRight:!0},i.checked=!0,b.noCloneChecked=i.cloneNode(!0).checked,g.disabled=!0,b.optDisabled=!h.disabled;try{delete
q.test}catch(s){b.deleteExpando=!1}!q.addEventListener&&q.attachEvent&&q.fireEvent&&(q.attachEvent("onclick",function(){b.noCloneEvent=!1}),q.cloneNode(!0).fireEvent("onclick")),i=c.createElement("input"),i.value="t",i.setAttribute("type","radio"),b.radioValue=i.value==="t",i.setAttribute("checked","checked"),q.appendChild(i),k=c.createDocumentFragment(),k.appendChild(q.lastChild),b.checkClone=k.cloneNode(!0).cloneNode(!0).lastChild.checked,b.appendChecked=i.checked,k.removeChild(i),k.appendChild(q),q.innerHTML="",a.getComputedStyle&&(j=c.createElement("div"),j.style.width="0",j.style.marginRight="0",q.style.width="2px",q.appendChild(j),b.reliableMarginRight=(parseInt((a.getComputedStyle(j,null)|
|{marginRight:0}).marginRight,10)||0)===0);if(q.attachEvent)for(o
in{submit:1,change:1,focusin:1})n="on"+o,p=n in q,p||
(q.setAttribute(n,"return;"),p=typeof
q[n]=="function"),b[o+"Bubbles"]=p;k.removeChild(q),k=g=h=j=q=i=null,f(function(){var
a,d,e,g,h,i,j,k,m,n,o,r=c.getElementsByTagName("body")[0];!r||
(j=1,k="position:absolute;top:0;left:0;width:1px;height:1px;margin:0;",m="visibility:hidden;border:0;",n="style='"+k+"border:5px
solid #000;padding:0;'",o="<div "+n+"><div></div></div>"+"<table "+n+"
cellpadding='0'
cellspacing='0'>"+"<tr><td></td></tr></table>",a=c.createElement("div"),a.style.cssText=m+"width:0;height:0;position:static;top:0;margin-top:"+j+"px",r.insertBefore(a,r.firstChild),q=c.createElement("div"),a.appendChild(q),q.innerHTML="<table><tr><td
style='padding:0;border:0;display:none'></td><td>t</td></tr></table>",l=q.getElementsByTagName("td"),p=l[0].offsetHeight===0,l[0].style.display="",l[1].style.display="none",b.reliableHiddenOffsets=p&&l[0].offsetHeight===0,q.innerHTML="",q.style.width=q.style.paddingLeft="1px",f.boxModel=b.boxModel=q.offsetWidth===2,typeof
q.style.zoom!="undefined"&&(q.style.display="inline",q.style.zoom=1,b.inlineBlockNeedsLayout=q.offsetWidth===2,q.style.display="",q.innerHTML="<div
style='width:4px;'></div>",b.shrinkWrapBlocks=q.offsetWidth!==2),q.style.cssText=k+m,q.innerHTML=o,d=q.firstChild,e=d.firstChild,h=d.nextSibling.firstChild.firstChild,i={doesNotAddBorder:e.offsetTop!==5,doesAddBorderForTableAndCells:h.offsetTop===5},e.style.position="fixed",e.style.top="20px",i.fixedPosition=e.offsetTop===20|
|
e.offsetTop===15,e.style.position=e.style.top="",d.style.overflow="hidden",d.style.position="relative",i.subtractsBorderForOverflowNotVisible=e.offsetTop===-5,i.doesNotIncludeMarginInBodyOffset=r.offsetTop!==j,r.removeChild(a),q=a=null,f.extend(b,i))});return
b}();var j=/^(?:\{.*\}|
\[.*\])$/,k=/([A-Z])/g;f.extend({cache:{},uuid:0,expando:"jQuery"+(f.fn.jquery+Math.random()).replace(/\D/g,""),noData:{embed:!0,object:"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000",applet:!0},hasData:function(a){a=a.nodeType?f.cache[a[f.expando]]:a[f.expando];return!!a&&!m(a)},data:function(a,c,d,e){if(!!f.acceptData(a)){var
g,h,i,j=f.expando,k=typeof
c=="string",l=a.nodeType,m=l?f.cache:a,n=l?a[j]:a[j]&&j,o=c==="events";if((!n|
|!m[n]||!o&&!e&&!m[n].data)&&k&&d===b)return;n||
(l?a[j]=n=++f.uuid:n=j),m[n]||(m[n]={},l||(m[n].toJSON=f.noop));if(typeof
c=="object"||typeof
c=="function")e?m[n]=f.extend(m[n],c):m[n].data=f.extend(m[n].data,c);g=h=m[n],e|
|(h.data||
(h.data={}),h=h.data),d!==b&&(h[f.camelCase(c)]=d);if(o&&!h[c])return
g.events;k?(i=h[c],i==null&&(i=h[f.camelCase(c)])):i=h;return
i}},removeData:function(a,b,c){if(!!f.acceptData(a)){var
d,e,g,h=f.expando,i=a.nodeType,j=i?f.cache:a,k=i?a[h]:h;if(!j[k])return;if(b){d=c?j[k]:j[k].data;if(d){f.isArray(b)|
|(b in d?b=[b]:(b=f.camelCase(b),b in
d?b=[b]:b=b.split(" ")));for(e=0,g=b.length;e<g;e++)delete
d[b[e]];if(!(c?m:f.isEmptyObject)(d))return}}if(!c){delete
j[k].data;if(!m(j[k]))return}f.support.deleteExpando||!j.setInterval?delete
j[k]:j[k]=null,i&&(f.support.deleteExpando?delete
a[h]:a.removeAttribute?a.removeAttribute(h):a[h]=null)}},_data:function(a,b,c){return
f.data(a,b,c,!0)},acceptData:function(a){if(a.nodeName){var
b=f.noData[a.nodeName.toLowerCase()];if(b)return
b!==!0&&a.getAttribute("classid")===b}return!0}}),f.fn.extend({data:function(a,c){var
d,e,g,h=null;if(typeof
a=="undefined"){if(this.length){h=f.data(this[0]);if(this[0].nodeType===1&&!f._data(this[0],"parsedAttrs")){e=this[0].attributes;for(var
i=0,j=e.length;i<j;i++)g=e[i].name,g.indexOf("data-")===0&&(g=f.camelCase(g.substring(5)),l(this[0],g,h[g]));f._data(this[0],"parsedAttrs",!0)}}return
h}if(typeof a=="object")return
this.each(function(){f.data(this,a)});d=a.split("."),d[1]=d[1]?"."+d[1]:"";if(c===b){h=this.triggerHandler("getData"+d[1]+"!",[d[0]]),h===b&&this.length&&(h=f.data(this[0],a),h=l(this[0],a,h));return
h===b&&d[1]?this.data(d[0]):h}return this.each(function(){var
b=f(this),e=[d[0],c];b.triggerHandler("setData"+d[1]+"!",e),f.data(this,a,c),b.triggerHandler("changeData"+d[1]+"!",e)})},removeData:function(a){return
this.each(function(){f.removeData(this,a)})}}),f.extend({_mark:function(a,b){a&&(b=(b|
|"fx")+"mark",f._data(a,b,(f._data(a,b)||
0)+1))},_unmark:function(a,b,c){a!==!0&&(c=b,b=a,a=!1);if(b){c=c||"fx";var
d=c+"mark",e=a?0:(f._data(b,d)||
1)-1;e?f._data(b,d,e):(f.removeData(b,d,!0),n(b,c,"mark"))}},queue:function(a,b,c){var
d;if(a){b=(b||"fx")+"queue",d=f._data(a,b),c&&(!d||
f.isArray(c)?d=f._data(a,b,f.makeArray(c)):d.push(c));return d||
[]}},dequeue:function(a,b){b=b||"fx";var
c=f.queue(a,b),d=c.shift(),e={};d==="inprogress"&&(d=c.shift()),d&&(b==="fx"&&c.unshift("inprogress"),f._data(a,b+".run",e),d.call(a,function(){f.dequeue(a,b)},e)),c.length|
|
(f.removeData(a,b+"queue "+b+".run",!0),n(a,b,"queue"))}}),f.fn.extend({queue:function(a,c){typeof
a!="string"&&(c=a,a="fx");if(c===b)return f.queue(this[0],a);return
this.each(function(){var
b=f.queue(this,a,c);a==="fx"&&b[0]!=="inprogress"&&f.dequeue(this,a)})},dequeue:function(a){return
this.each(function(){f.dequeue(this,a)})},delay:function(a,b){a=f.fx?f.fx.speeds[a]|
|a:a,b=b||"fx";return this.queue(b,function(b,c){var
d=setTimeout(b,a);c.stop=function(){clearTimeout(d)}})},clearQueue:function(a){return
this.queue(a||"fx",[])},promise:function(a,c){function m(){--h||
d.resolveWith(e,[e])}typeof a!="string"&&(c=a,a=b),a=a||"fx";var
d=f.Deferred(),e=this,g=e.length,h=1,i=a+"defer",j=a+"queue",k=a+"mark",l;while(g--)if(l=f.data(e[g],i,b,!0)|
|(f.data(e[g],j,b,!0)||
f.data(e[g],k,b,!0))&&f.data(e[g],i,f.Callbacks("once
memory"),!0))h++,l.add(m);m();return d.promise()}});var
o=/[\n\t\r]/g,p=/\s+/,q=/\r/g,r=/^(?:button|input)$/i,s=/^(?:button|input|
object|select|textarea)$/i,t=/^a(?:rea)?$/i,u=/^(?:autofocus|autoplay|async|
checked|controls|defer|disabled|hidden|loop|multiple|open|readonly|required|
scoped|
selected)$/i,v=f.support.getSetAttribute,w,x,y;f.fn.extend({attr:function(a,b){return
f.access(this,a,b,!0,f.attr)},removeAttr:function(a){return
this.each(function(){f.removeAttr(this,a)})},prop:function(a,b){return
f.access(this,a,b,!0,f.prop)},removeProp:function(a){a=f.propFix[a]||
a;return this.each(function(){try{this[a]=b,delete
this[a]}catch(c){}})},addClass:function(a){var
b,c,d,e,g,h,i;if(f.isFunction(a))return
this.each(function(b){f(this).addClass(a.call(this,b,this.className))});if(a&&typeof
a=="string"){b=a.split(p);for(c=0,d=this.length;c<d;c++){e=this[c];if(e.nodeType===1)if(!e.className&&b.length===1)e.className=a;else{g=" "+e.className+" ";for(h=0,i=b.length;h<i;h++)~g.indexOf(" "+b[h]+" ")|
|(g+=b[h]+" ");e.className=f.trim(g)}}}return
this},removeClass:function(a){var c,d,e,g,h,i,j;if(f.isFunction(a))return
this.each(function(b){f(this).removeClass(a.call(this,b,this.className))});if(a&&typeof
a=="string"||a===b){c=(a|
|"").split(p);for(d=0,e=this.length;d<e;d++){g=this[d];if(g.nodeType===1&&g.className)if(a){h=(" "+g.className+" ").replace(o," ");for(i=0,j=c.length;i<j;i++)h=h.replace(" "+c[i]+" "," ");g.className=f.trim(h)}else
g.className=""}}return this},toggleClass:function(a,b){var c=typeof
a,d=typeof b=="boolean";if(f.isFunction(a))return
this.each(function(c){f(this).toggleClass(a.call(this,c,this.className,b),b)});return
this.each(function(){if(c==="string"){var
e,g=0,h=f(this),i=b,j=a.split(p);while(e=j[g++])i=d?i:!h.hasClass(e),h[i?"addClass":"removeClass"](e)}else
if(c==="undefined"||
c==="boolean")this.className&&f._data(this,"__className__",this.className),this.className=this.className|
|a===!1?"":f._data(this,"__className__")||""})},hasClass:function(a){var
b=" "+a+" ",c=0,d=this.length;for(;c<d;c++)if(this[c].nodeType===1&&(" "+this[c].className+" ").replace(o," ").indexOf(b)>-1)return!0;return!1},val:function(a){var
c,d,e,g=this[0];{if(!!arguments.length){e=f.isFunction(a);return
this.each(function(d){var
g=f(this),h;if(this.nodeType===1){e?h=a.call(this,d,g.val()):h=a,h==null?h="":typeof
h=="number"?h+="":f.isArray(h)&&(h=f.map(h,function(a){return
a==null?"":a+""})),c=f.valHooks[this.nodeName.toLowerCase()]||
f.valHooks[this.type];if(!c||!("set"in c)||
c.set(this,h,"value")===b)this.value=h}})}if(g){c=f.valHooks[g.nodeName.toLowerCase()]|
|f.valHooks[g.type];if(c&&"get"in c&&(d=c.get(g,"value"))!==b)return
d;d=g.value;return typeof
d=="string"?d.replace(q,""):d==null?"":d}}}}),f.extend({valHooks:{option:{get:function(a){var
b=a.attributes.value;return!b||
b.specified?a.value:a.text}},select:{get:function(a){var
b,c,d,e,g=a.selectedIndex,h=[],i=a.options,j=a.type==="select-one";if(g<0)return
null;c=j?g:0,d=j?g+1:i.length;for(;c<d;c++){e=i[c];if(e.selected&&(f.support.optDisabled?!e.disabled:e.getAttribute("disabled")===null)&&(!e.parentNode.disabled|
|!f.nodeName(e.parentNode,"optgroup"))){b=f(e).val();if(j)return
b;h.push(b)}}if(j&&!h.length&&i.length)return f(i[g]).val();return
h},set:function(a,b){var
c=f.makeArray(b);f(a).find("option").each(function(){this.selected=f.inArray(f(this).val(),c)>=0}),c.length|
|(a.selectedIndex=-1);return
c}}},attrFn:{val:!0,css:!0,html:!0,text:!0,data:!0,width:!0,height:!0,offset:!0},attr:function(a,c,d,e){var
g,h,i,j=a.nodeType;if(!!a&&j!==3&&j!==8&&j!==2){if(e&&c in f.attrFn)return
f(a)[c](d);if(typeof a.getAttribute=="undefined")return
f.prop(a,c,d);i=j!==1|
|!f.isXMLDoc(a),i&&(c=c.toLowerCase(),h=f.attrHooks[c]||
(u.test(c)?x:w));if(d!==b){if(d===null){f.removeAttr(a,c);return}if(h&&"set"in
h&&i&&(g=h.set(a,d,c))!==b)return g;a.setAttribute(c,""+d);return
d}if(h&&"get"in h&&i&&(g=h.get(a,c))!==null)return
g;g=a.getAttribute(c);return g===null?b:g}},removeAttr:function(a,b){var
c,d,e,g,h=0;if(b&&a.nodeType===1){d=b.toLowerCase().split(p),g=d.length;for(;h<g;h++)e=d[h],e&&(c=f.propFix[e]|
|e,f.attr(a,e,""),a.removeAttribute(v?e:c),u.test(e)&&c in
a&&(a[c]=!1))}},attrHooks:{type:{set:function(a,b){if(r.test(a.nodeName)&&a.parentNode)f.error("type
property can't be changed");else
if(!f.support.radioValue&&b==="radio"&&f.nodeName(a,"input")){var
c=a.value;a.setAttribute("type",b),c&&(a.value=c);return
b}}},value:{get:function(a,b){if(w&&f.nodeName(a,"button"))return
w.get(a,b);return b in
a?a.value:null},set:function(a,b,c){if(w&&f.nodeName(a,"button"))return
w.set(a,b,c);a.value=b}}},propFix:{tabindex:"tabIndex",readonly:"readOnly","for":"htmlFor","class":"className",maxlength:"maxLength",cellspacing:"cellSpacing",cellpadding:"cellPadding",rowspan:"rowSpan",colspan:"colSpan",usemap:"useMap",frameborder:"frameBorder",contenteditable:"contentEditable"},prop:function(a,c,d){var
e,g,h,i=a.nodeType;if(!!a&&i!==3&&i!==8&&i!==2){h=i!==1|
|!f.isXMLDoc(a),h&&(c=f.propFix[c]||c,g=f.propHooks[c]);return
d!==b?g&&"set"in g&&(e=g.set(a,d,c))!==b?e:a[c]=d:g&&"get"in
g&&(e=g.get(a,c))!==null?e:a[c]}},propHooks:{tabIndex:{get:function(a){var
c=a.getAttributeNode("tabindex");return
c&&c.specified?parseInt(c.value,10):s.test(a.nodeName)||
t.test(a.nodeName)&&a.href?0:b}}}}),f.attrHooks.tabindex=f.propHooks.tabIndex,x={get:function(a,c){var
d,e=f.prop(a,c);return e===!0||typeof
e!="boolean"&&(d=a.getAttributeNode(c))&&d.nodeValue!==!1?c.toLowerCase():b},set:function(a,b,c){var
d;b===!1?f.removeAttr(a,c):(d=f.propFix[c]||c,d in
a&&(a[d]=!0),a.setAttribute(c,c.toLowerCase()));return c}},v||
(y={name:!0,id:!0},w=f.valHooks.button={get:function(a,c){var
d;d=a.getAttributeNode(c);return
d&&(y[c]?d.nodeValue!=="":d.specified)?d.nodeValue:b},set:function(a,b,d){var
e=a.getAttributeNode(d);e||
(e=c.createAttribute(d),a.setAttributeNode(e));return
e.nodeValue=b+""}},f.attrHooks.tabindex.set=w.set,f.each(["width","height"],function(a,b){f.attrHooks[b]=f.extend(f.attrHooks[b],{set:function(a,c){if(c===""){a.setAttribute(b,"auto");return
c}}})}),f.attrHooks.contenteditable={get:w.get,set:function(a,b,c){b===""&&(b="false"),w.set(a,b,c)}}),f.support.hrefNormalized|
|
f.each(["href","src","width","height"],function(a,c){f.attrHooks[c]=f.extend(f.attrHooks[c],{get:function(a){var
d=a.getAttribute(c,2);return d===null?b:d}})}),f.support.style||
(f.attrHooks.style={get:function(a){return a.style.cssText.toLowerCase()||
b},set:function(a,b){return a.style.cssText=""+b}}),f.support.optSelected||
(f.propHooks.selected=f.extend(f.propHooks.selected,{get:function(a){var
b=a.parentNode;b&&(b.selectedIndex,b.parentNode&&b.parentNode.selectedIndex);return
null}})),f.support.enctype||
(f.propFix.enctype="encoding"),f.support.checkOn||
f.each(["radio","checkbox"],function(){f.valHooks[this]={get:function(a){return
a.getAttribute("value")===null?"on":a.value}}}),f.each(["radio","checkbox"],function(){f.valHooks[this]=f.extend(f.valHooks[this],{set:function(a,b){if(f.isArray(b))return
a.checked=f.inArray(f(a).val(),b)>=0}})});var z=/^(?:textarea|input|
select)$/i,A=/^([^\.]*)?(?:\.(.+))?$/,B=/\bhover(\.\S+)?\b/,C=/^key/,D=/^(?:mouse|
contextmenu)|click/,E=/^(?:focusinfocus|
focusoutblur)$/,F=/^(\w*)(?:#([\w\-]+))?(?:\.([\w\-]+))?$/,G=function(a){var
b=F.exec(a);b&&(b[1]=(b[1]||"").toLowerCase(),b[3]=b[3]&&new RegExp("(?:^|
\\s)"+b[3]+"(?:\\s|$)"));return b},H=function(a,b){var c=a.attributes||
{};return(!b[1]||a.nodeName.toLowerCase()===b[1])&&(!b[2]||(
c.id||
{}).value===b[2])&&(!b[3]||b[3].test((c["class"]||
{}).value))},I=function(a){return
f.event.special.hover?a:a.replace(B,"mouseenter$1 mouseleave$1")};
+f.event={add:function(a,c,d,e,g){var
h,i,j,k,l,m,n,o,p,q,r,s;if(!(a.nodeType===3||a.nodeType===8||!c||!d|
|!(h=f._data(a)))){d.handler&&(p=d,d=p.handler),d.guid||
(d.guid=f.guid++),j=h.events,j||(h.events=j={}),i=h.handle,i||
(h.handle=i=function(a){return typeof f!="undefined"&&(!a||
f.event.triggered!==a.type)?f.event.dispatch.apply(i.elem,arguments):b},i.elem=a),c=f.trim(I(c)).split(" ");for(k=0;k<c.length;k++){l=A.exec(c[k])|
|[],m=l[1],n=(l[2]||"").split(".").sort(),s=f.event.special[m]||
{},m=(g?s.delegateType:s.bindType)||m,s=f.event.special[m]||
{},o=f.extend({type:m,origType:l[1],data:e,handler:d,guid:d.guid,selector:g,quick:G(g),namespace:n.join(".")},p),r=j[m];if(!r){r=j[m]=[],r.delegateCount=0;if(!s.setup|
|
s.setup.call(a,e,n,i)===!1)a.addEventListener?a.addEventListener(m,i,!1):a.attachEvent&&a.attachEvent("on"+m,i)}s.add&&(s.add.call(a,o),o.handler.guid|
|
(o.handler.guid=d.guid)),g?r.splice(r.delegateCount++,0,o):r.push(o),f.event.global[m]=!0}a=null}},global:{},remove:function(a,b,c,d,e){var
g=f.hasData(a)&&f._data(a),h,i,j,k,l,m,n,o,p,q,r,s;if(!!g&&!!(o=g.events)){b=f.trim(I(b|
|"")).split(" ");for(h=0;h<b.length;h++){i=A.exec(b[h])||
[],j=k=i[1],l=i[2];if(!j){for(j in
o)f.event.remove(a,j+b[h],c,d,!0);continue}p=f.event.special[j]||
{},j=(d?p.delegateType:p.bindType)||j,r=o[j]||[],m=r.length,l=l?new
RegExp("(^|\\.)"+l.split(".").sort().join("\\.(?:.*\\.)?")+"(\\.|
$)"):null;for(n=0;n<r.length;n++)s=r[n],(e||k===s.origType)&&(!c||
c.guid===s.guid)&&(!l||l.test(s.namespace))&&(!d||d===s.selector||
d==="**"&&s.selector)&&(r.splice(n--,1),s.selector&&r.delegateCount--,p.remove&&p.remove.call(a,s));r.length===0&&m!==r.length&&((!p.teardown|
|p.teardown.call(a,l)===!1)&&f.removeEvent(a,j,g.handle),delete
o[j])}f.isEmptyObject(o)&&(q=g.handle,q&&(q.elem=null),f.removeData(a,["events","handle"],!0))}},customEvent:{getData:!0,setData:!0,changeData:!0},trigger:function(c,d,e,g){if(!e|
|e.nodeType!==3&&e.nodeType!==8){var h=c.type||
c,i=[],j,k,l,m,n,o,p,q,r,s;if(E.test(h+f.event.triggered))return;h.indexOf("!")>=0&&(h=h.slice(0,-1),k=!0),h.indexOf(".")>=0&&(i=h.split("."),h=i.shift(),i.sort());if((!e|
|f.event.customEvent[h])&&!f.event.global[h])return;c=typeof
c=="object"?c[f.expando]?c:new f.Event(h,c):new
f.Event(h),c.type=h,c.isTrigger=!0,c.exclusive=k,c.namespace=i.join("."),c.namespace_re=c.namespace?new
RegExp("(^|\\.)"+i.join("\\.(?:.*\\.)?")+"(\\.|
$)"):null,o=h.indexOf(":")<0?"on"+h:"";if(!e){j=f.cache;for(l in
j)j[l].events&&j[l].events[h]&&f.event.trigger(c,d,j[l].handle.elem,!0);return}c.result=b,c.target|
|(c.target=e),d=d!=null?f.makeArray(d):[],d.unshift(c),p=f.event.special[h]|
|{};if(p.trigger&&p.trigger.apply(e,d)===!1)return;r=[[e,p.bindType||
h]];if(!g&&!p.noBubble&&!f.isWindow(e)){s=p.delegateType||
h,m=E.test(s+h)?e:e.parentNode,n=null;for(;m;m=m.parentNode)r.push([m,s]),n=m;n&&n===e.ownerDocument&&r.push([n.defaultView|
|n.parentWindow||
a,s])}for(l=0;l<r.length&&!c.isPropagationStopped();l++)m=r[l][0],c.type=r[l][1],q=(f._data(m,"events")|
|
{})[c.type]&&f._data(m,"handle"),q&&q.apply(m,d),q=o&&m[o],q&&f.acceptData(m)&&q.apply(m,d)===!1&&c.preventDefault();c.type=h,!g&&!c.isDefaultPrevented()&&(!p._default|
|p._default.apply(e.ownerDocument,d)===!1)&&(h!=="click"|
|!f.nodeName(e,"a"))&&f.acceptData(e)&&o&&e[h]&&(h!=="focus"&&h!=="blur"||
c.target.offsetWidth!==0)&&!f.isWindow(e)&&(n=e[o],n&&(e[o]=null),f.event.triggered=h,e[h](),f.event.triggered=b,n&&(e[o]=n));return
c.result}},dispatch:function(c){c=f.event.fix(c||a.event);var
d=(f._data(this,"events")||{})[c.type]||
[],e=d.delegateCount,g=[].slice.call(arguments,0),h=!c.exclusive&&!c.namespace,i=[],j,k,l,m,n,o,p,q,r,s,t;g[0]=c,c.delegateTarget=this;if(e&&!c.target.disabled&&(!c.button|
|c.type!=="click")){m=f(this),m.context=this.ownerDocument||
this;for(l=c.target;l!=this;l=l.parentNode||
this){o={},q=[],m[0]=l;for(j=0;j<e;j++)r=d[j],s=r.selector,o[s]===b&&(o[s]=r.quick?H(l,r.quick):
m.is(s)),o[s]&&q.push(r);q.length&&i.push({elem:l,matches:q})}}d.length>e&&i.push({elem:this,matches:d.slice(e)});for(j=0;j<i.length&&!c.isPropagationStopped();j++){p=i[j],c.currentTarget=p.elem;for(k=0;k<p.matches.length&&!c.isImmediatePropagationStopped();k++){r=p.matches[k];if(h|
|!c.namespace&&!r.namespace||
c.namespace_re&&c.namespace_re.test(r.namespace))c.data=r.data,c.handleObj=r,n=((f.event.special[r.origType]|
|{}).handle||
r.handler).apply(p.elem,g),n!==b&&(c.result=n,n===!1&&(c.preventDefault(),c.stopPropagation()))}}return
c.result},props:"attrChange attrName relatedNode srcElement altKey bubbles
cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey
target timeStamp view which".split(" "),fixHooks:{},keyHooks:{props:"char
charCode key
keyCode".split(" "),filter:function(a,b){a.which==null&&(a.which=b.charCode!=null?b.charCode:b.keyCode);return
a}},mouseHooks:{props:"button buttons clientX clientY fromElement offsetX
offsetY pageX pageY screenX screenY
toElement".split(" "),filter:function(a,d){var
e,f,g,h=d.button,i=d.fromElement;a.pageX==null&&d.clientX!=null&&(e=a.target.ownerDocument|
|c,f=e.documentElement,g=e.body,a.pageX=d.clientX+(f&&f.scrollLeft||
g&&g.scrollLeft||0)-(f&&f.clientLeft||g&&g.clientLeft||
0),a.pageY=d.clientY+(f&&f.scrollTop||g&&g.scrollTop||0)-(f&&f.clientTop||
g&&g.clientTop||
0)),!a.relatedTarget&&i&&(a.relatedTarget=i===a.target?d.toElement:i),!a.which&&h!==b&&(a.which=h&1?1:h&2?3:h&4?2:0);return
a}},fix:function(a){if(a[f.expando])return a;var
d,e,g=a,h=f.event.fixHooks[a.type]||
{},i=h.props?this.props.concat(h.props):this.props;a=f.Event(g);for(d=i.length;d;)e=i[--d],a[e]=g[e];a.target|
|(a.target=g.srcElement||
c),a.target.nodeType===3&&(a.target=a.target.parentNode),a.metaKey===b&&(a.metaKey=a.ctrlKey);return
h.filter?h.filter(a,g):a},special:{ready:{setup:f.bindReady},load:{noBubble:!0},focus:{delegateType:"focusin"},blur:{delegateType:"focusout"},beforeunload:{setup:function(a,b,c){f.isWindow(this)&&(this.onbeforeunload=c)},teardown:function(a,b){this.onbeforeunload===b&&(this.onbeforeunload=null)}}},simulate:function(a,b,c,d){var
e=f.extend(new
f.Event,c,{type:a,isSimulated:!0,originalEvent:{}});d?f.event.trigger(e,null,b):f.event.dispatch.call(b,e),e.isDefaultPrevented()&&c.preventDefault()}},f.event.handle=f.event.dispatch,f.removeEvent=c.removeEventListener?function(a,b,c){a.removeEventListener&&a.removeEventListener(b,c,!1)}:function(a,b,c){a.detachEvent&&a.detachEvent("on"+b,c)},f.Event=function(a,b){if(!(this
instanceof f.Event))return new
f.Event(a,b);a&&a.type?(this.originalEvent=a,this.type=a.type,this.isDefaultPrevented=a.defaultPrevented|
|a.returnValue===!1||
a.getPreventDefault&&a.getPreventDefault()?K:J):this.type=a,b&&f.extend(this,b),this.timeStamp=a&&a.timeStamp|
|
f.now(),this[f.expando]=!0},f.Event.prototype={preventDefault:function(){this.isDefaultPrevented=K;var
a=this.originalEvent;!a||
(a.preventDefault?a.preventDefault():a.returnValue=!1)},stopPropagation:function(){this.isPropagationStopped=K;var
a=this.originalEvent;!a||
(a.stopPropagation&&a.stopPropagation(),a.cancelBubble=!0)},stopImmediatePropagation:function(){this.isImmediatePropagationStopped=K,this.stopPropagation()},isDefaultPrevented:J,isPropagationStopped:J,isImmediatePropagationStopped:J},f.each({mouseenter:"mouseover",mouseleave:"mouseout"},function(a,b){f.event.special[a]={delegateType:b,bindType:b,handle:function(a){var
c=this,d=a.relatedTarget,e=a.handleObj,g=e.selector,h;if(!d||
d!==c&&!f.contains(c,d))a.type=e.origType,h=e.handler.apply(this,arguments),a.type=b;return
h}}}),f.support.submitBubbles||
(f.event.special.submit={setup:function(){if(f.nodeName(this,"form"))return!1;f.event.add(this,"click._submit
keypress._submit",function(a){var c=a.target,d=f.nodeName(c,"input")||
f.nodeName(c,"button")?c.form:b;d&&!d._submit_attached&&(f.event.add(d,"submit._submit",function(a){this.parentNode&&!a.isTrigger&&f.event.simulate("submit",this.parentNode,a,!0)}),d._submit_attached=!0)})},teardown:function(){if(f.nodeName(this,"form"))return!1;f.event.remove(this,"._submit")}}),f.support.changeBubbles|
|
(f.event.special.change={setup:function(){if(z.test(this.nodeName)){if(this.type==="checkbox"|
|
this.type==="radio")f.event.add(this,"propertychange._change",function(a){a.originalEvent.propertyName==="checked"&&(this._just_changed=!0)}),f.event.add(this,"click._change",function(a){this._just_changed&&!a.isTrigger&&(this._just_changed=!1,f.event.simulate("change",this,a,!0))});return!1}f.event.add(this,"beforeactivate._change",function(a){var
b=a.target;z.test(b.nodeName)&&!b._change_attached&&(f.event.add(b,"change._change",function(a){this.parentNode&&!a.isSimulated&&!a.isTrigger&&f.event.simulate("change",this.parentNode,a,!0)}),b._change_attached=!0)})},handle:function(a){var
b=a.target;if(this!==b||a.isSimulated||a.isTrigger||
b.type!=="radio"&&b.type!=="checkbox")return
a.handleObj.handler.apply(this,arguments)},teardown:function(){f.event.remove(this,"._change");return
z.test(this.nodeName)}}),f.support.focusinBubbles||
f.each({focus:"focusin",blur:"focusout"},function(a,b){var
d=0,e=function(a){f.event.simulate(b,a.target,f.event.fix(a),!0)};f.event.special[b]={setup:function(){d++===0&&c.addEventListener(a,e,!0)},teardown:function(){--d===0&&c.removeEventListener(a,e,!0)}}}),f.fn.extend({on:function(a,c,d,e,g){var
h,i;if(typeof a=="object"){typeof c!="string"&&(d=c,c=b);for(i in
a)this.on(i,c,d,a[i],g);return
this}d==null&&e==null?(e=c,d=c=b):e==null&&(typeof
c=="string"?(e=d,d=b):(e=d,d=c,c=b));if(e===!1)e=J;else if(!e)return
this;g===1&&(h=e,e=function(a){f().off(a);return
h.apply(this,arguments)},e.guid=h.guid||(h.guid=f.guid++));return
this.each(function(){f.event.add(this,a,e,d,c)})},one:function(a,b,c,d){return
this.on.call(this,a,b,c,d,1)},off:function(a,c,d){if(a&&a.preventDefault&&a.handleObj){var
e=a.handleObj;f(a.delegateTarget).off(e.namespace?e.type+"."+e.namespace:e.type,e.selector,e.handler);return
this}if(typeof a=="object"){for(var g in a)this.off(g,c,a[g]);return
this}if(c===!1||typeof c=="function")d=c,c=b;d===!1&&(d=J);return
this.each(function(){f.event.remove(this,a,d,c)})},bind:function(a,b,c){return
this.on(a,null,b,c)},unbind:function(a,b){return
this.off(a,null,b)},live:function(a,b,c){f(this.context).on(a,this.selector,b,c);return
this},die:function(a,b){f(this.context).off(a,this.selector||"**",b);return
this},delegate:function(a,b,c,d){return
this.on(b,a,c,d)},undelegate:function(a,b,c){return
arguments.length==1?this.off(a,"**"):this.off(b,a,c)},trigger:function(a,b){return
this.each(function(){f.event.trigger(a,b,this)})},triggerHandler:function(a,b){if(this[0])return
f.event.trigger(a,b,this[0],!0)},toggle:function(a){var
b=arguments,c=a.guid||f.guid++,d=0,e=function(c){var
e=(f._data(this,"lastToggle"+a.guid)||
0)%d;f._data(this,"lastToggle"+a.guid,e+1),c.preventDefault();return
b[e].apply(this,arguments)|
|!1};e.guid=c;while(d<b.length)b[d++].guid=c;return
this.click(e)},hover:function(a,b){return this.mouseenter(a).mouseleave(b||
a)}}),f.each("blur focus focusin focusout load resize scroll unload click
dblclick mousedown mouseup mousemove mouseover mouseout mouseenter
mouseleave change select submit keydown keypress keyup error
contextmenu".split(" "),function(a,b){f.fn[b]=function(a,c){c==null&&(c=a,a=null);return
arguments.length>0?this.on(b,null,a,c):this.trigger(b)},f.attrFn&&(f.attrFn[b]=!0),C.test(b)&&(f.event.fixHooks[b]=f.event.keyHooks),D.test(b)&&(f.event.fixHooks[b]=f.event.mouseHooks)}),function(){function
x(a,b,c,e,f,g){for(var h=0,i=e.length;h<i;h++){var j=e[h];if(j){var
k=!1;j=j[a];while(j){if(j[d]===c){k=e[j.sizset];break}if(j.nodeType===1){g||
(j[d]=c,j.sizset=h);if(typeof b!="string"){if(j===b){k=!0;break}}else
if(m.filter(b,[j]).length>0){k=j;break}}j=j[a]}e[h]=k}}}function
w(a,b,c,e,f,g){for(var h=0,i=e.length;h<i;h++){var j=e[h];if(j){var
k=!1;j=j[a];while(j){if(j[d]===c){k=e[j.sizset];break}j.nodeType===1&&!g&&(j[d]=c,j.sizset=h);if(j.nodeName.toLowerCase()===b){k=j;break}j=j[a]}e[h]=k}}}var
a=/((?:\((?:\([^()]+\)|[^()]+)+\)|\[(?:\[[^\[\]]*\]|['"][^'"]*['"]|
[^\[\]'"]+)+\]|\\.|[^ >+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|
\n)*)/g,d="sizcache"+(Math.random()+"").replace(".",""),e=0,g=Object.prototype.toString,h=!1,i=!0,j=/\\/g,k=/\r\n/g,l=/\W/;[0,0].sort(function(){i=!1;return
0});var m=function(b,d,e,f){e=e||[],d=d||c;var
h=d;if(d.nodeType!==1&&d.nodeType!==9)return[];if(!b||typeof
b!="string")return e;var
i,j,k,l,n,q,r,t,u=!0,v=m.isXML(d),w=[],x=b;do{a.exec(""),i=a.exec(x);if(i){x=i[3],w.push(i[1]);if(i[2]){l=i[3];break}}}while(i);if(w.length>1&&p.exec(b))if(w.length===2&&o.relative[w[0]])j=y(w[0]+w[1],d,f);else{j=o.relative[w[0]]?[d]:m(w.shift(),d);while(w.length)b=w.shift(),o.relative[b]&&(b+=w.shift()),j=y(b,j,f)}else{!f&&w.length>1&&d.nodeType===9&&!v&&o.match.ID.test(w[0])&&!o.match.ID.test(w[w.length-1])&&(n=m.find(w.shift(),d,v),d=n.expr?m.filter(n.expr,n.set)[0]:n.set[0]);if(d){n=f?{expr:w.pop(),set:s(f)}:m.find(w.pop(),w.length===1&&(w[0]==="~"|
|
w[0]==="+")&&d.parentNode?d.parentNode:d,v),j=n.expr?m.filter(n.expr,n.set):n.set,w.length>0?k=s(j):u=!1;while(w.length)q=w.pop(),r=q,o.relative[q]?r=w.pop():q="",r==null&&(r=d),o.relative[q](k,r,v)}else
k=w=[]}k||(k=j),k||m.error(q||b);if(g.call(k)==="[object
Array]")if(!u)e.push.apply(e,k);else
if(d&&d.nodeType===1)for(t=0;k[t]!=null;t++)k[t]&&(k[t]===!0||
k[t].nodeType===1&&m.contains(d,k[t]))&&e.push(j[t]);else
for(t=0;k[t]!=null;t++)k[t]&&k[t].nodeType===1&&e.push(j[t]);else
s(k,e);l&&(m(l,h,e,f),m.uniqueSort(e));return
e};m.uniqueSort=function(a){if(u){h=i,a.sort(u);if(h)for(var
b=1;b<a.length;b++)a[b]===a[b-1]&&a.splice(b--,1)}return
a},m.matches=function(a,b){return
m(a,null,null,b)},m.matchesSelector=function(a,b){return
m(b,null,null,[a]).length>0},m.find=function(a,b,c){var
d,e,f,g,h,i;if(!a)return[];for(e=0,f=o.order.length;e<f;e++){h=o.order[e];if(g=o.leftMatch[h].exec(a)){i=g[1],g.splice(1,1);if(i.substr(i.length-1)!=="\\"){g[1]=(g[1]|
|"").replace(j,""),d=o.find[h](g,b,c);if(d!=null){a=a.replace(o.match[h],"");break}}}}d|
|(d=typeof
b.getElementsByTagName!="undefined"?b.getElementsByTagName("*"):[]);return{set:d,expr:a}},m.filter=function(a,c,d,e){var
f,g,h,i,j,k,l,n,p,q=a,r=[],s=c,t=c&&c[0]&&m.isXML(c[0]);while(a&&c.length){for(h
in
o.filter)if((f=o.leftMatch[h].exec(a))!=null&&f[2]){k=o.filter[h],l=f[1],g=!1,f.splice(1,1);if(l.substr(l.length-1)==="\\")continue;s===r&&(r=[]);if(o.preFilter[h]){f=o.preFilter[h](f,s,d,r,e,t);if(!f)g=i=!0;else
if(f===!0)continue}if(f)for(n=0;(j=s[n])!=null;n++)j&&(i=k(j,f,n,s),p=e^i,d&&i!=null?p?g=!0:s[n]=!1:p&&(r.push(j),g=!0));if(i!==b){d|
|
(s=r),a=a.replace(o.match[h],"");if(!g)return[];break}}if(a===q)if(g==null)m.error(a);else
break;q=a}return s},m.error=function(a){throw new Error("Syntax error,
unrecognized expression: "+a)};var n=m.getText=function(a){var
b,c,d=a.nodeType,e="";if(d){if(d===1||d===9){if(typeof
a.textContent=="string")return a.textContent;if(typeof
a.innerText=="string")return
a.innerText.replace(k,"");for(a=a.firstChild;a;a=a.nextSibling)e+=n(a)}else
if(d===3||d===4)return a.nodeValue}else
for(b=0;c=a[b];b++)c.nodeType!==8&&(e+=n(c));return
e},o=m.selectors={order:["ID","NAME","TAG"],match:{ID:/#((?:[\w\u00c0-\uFFFF\-]|
\\.)+)/,CLASS:/\.((?:[\w\u00c0-\uFFFF\-]|
\\.)+)/,NAME:/\[name=['"]*((?:[\w\u00c0-\uFFFF\-]|
\\.)+)['"]*\]/,ATTR:/\[\s*((?:[\w\u00c0-\uFFFF\-]|
\\.)+)\s*(?:(\S?=)\s*(?:(['"])(.*?)\3|(#?(?:[\w\u00c0-\uFFFF\-]|\\.)*)|)|
)\s*\]/,TAG:/^((?:[\w\u00c0-\uFFFF\*\-]|\\.)+)/,CHILD:/:(only|nth|last|
first)-child(?:\(\s*(even|odd|(?:[+\-]?\d+|
(?:[+\-]?\d*)?n\s*(?:[+\-]\s*\d+)?))\s*\))?/,POS:/:(nth|eq|gt|lt|first|last|
even|odd)(?:\((\d*)\))?(?=[^\-]|$)/,PSEUDO:/:((?:[\w\u00c0-\uFFFF\-]|
\\.)+)(?:\((['"]?)((?:\([^\)]+\)|
[^\(\)]*)+)\2\))?/},leftMatch:{},attrMap:{"class":"className","for":"htmlFor"},attrHandle:{href:function(a){return
a.getAttribute("href")},type:function(a){return
a.getAttribute("type")}},relative:{"+":function(a,b){var c=typeof
b=="string",d=c&&!l.test(b),e=c&&!d;d&&(b=b.toLowerCase());for(var
f=0,g=a.length,h;f<g;f++)if(h=a[f]){while((h=h.previousSibling)&&h.nodeType!==1);a[f]=e|
|h&&h.nodeName.toLowerCase()===b?h|
|!1:h===b}e&&m.filter(b,a,!0)},">":function(a,b){var c,d=typeof
b=="string",e=0,f=a.length;if(d&&!l.test(b)){b=b.toLowerCase();for(;e<f;e++){c=a[e];if(c){var
g=c.parentNode;a[e]=g.nodeName.toLowerCase()===b?g:!1}}}else{for(;e<f;e++)c=a[e],c&&(a[e]=d?c.parentNode:c.parentNode===b);d&&m.filter(b,a,!0)}},"":function(a,b,c){var
d,f=e++,g=x;typeof
b=="string"&&!l.test(b)&&(b=b.toLowerCase(),d=b,g=w),g("parentNode",b,f,a,d,c)},"~":function(a,b,c){var
d,f=e++,g=x;typeof
b=="string"&&!l.test(b)&&(b=b.toLowerCase(),d=b,g=w),g("previousSibling",b,f,a,d,c)}},find:{ID:function(a,b,c){if(typeof
b.getElementById!="undefined"&&!c){var d=b.getElementById(a[1]);return
d&&d.parentNode?[d]:[]}},NAME:function(a,b){if(typeof
b.getElementsByName!="undefined"){var
c=[],d=b.getElementsByName(a[1]);for(var
e=0,f=d.length;e<f;e++)d[e].getAttribute("name")===a[1]&&c.push(d[e]);return
c.length===0?null:c}},TAG:function(a,b){if(typeof
b.getElementsByTagName!="undefined")return
b.getElementsByTagName(a[1])}},preFilter:{CLASS:function(a,b,c,d,e,f){a=" "+a[1].replace(j,"")+" ";if(f)return
a;for(var
g=0,h;(h=b[g])!=null;g++)h&&(e^(h.className&&(" "+h.className+" ").replace(/[\t\n\r]/g," ").indexOf(a)>=0)?c|
|d.push(h):c&&(b[g]=!1));return!1},ID:function(a){return
a[1].replace(j,"")},TAG:function(a,b){return
a[1].replace(j,"").toLowerCase()},CHILD:function(a){if(a[1]==="nth"){a[2]||
m.error(a[0]),a[2]=a[2].replace(/^\+|\s*/g,"");var
b=/(-?)(\d*)(?:n([+\-]?\d*))?/.exec(a[2]==="even"&&"2n"||
a[2]==="odd"&&"2n+1"||!/\D/.test(a[2])&&"0n+"+a[2]||a[2]);a[2]=b[1]+(b[2]||
1)-0,a[3]=b[3]-0}else a[2]&&m.error(a[0]);a[0]=e++;return
a},ATTR:function(a,b,c,d,e,f){var
g=a[1]=a[1].replace(j,"");!f&&o.attrMap[g]&&(a[1]=o.attrMap[g]),a[4]=(a[4]||
a[5]||"").replace(j,""),a[2]==="~="&&(a[4]=" "+a[4]+" ");return
a},PSEUDO:function(b,c,d,e,f){if(b[1]==="not")if((a.exec(b[3])|
|"").length>1||/^\w/.test(b[3]))b[3]=m(b[3],null,null,c);else{var
g=m.filter(b[3],c,d,!0^f);d||e.push.apply(e,g);return!1}else
if(o.match.POS.test(b[0])||o.match.CHILD.test(b[0]))return!0;return
b},POS:function(a){a.unshift(!0);return
a}},filters:{enabled:function(a){return
a.disabled===!1&&a.type!=="hidden"},disabled:function(a){return
a.disabled===!0},checked:function(a){return
a.checked===!0},selected:function(a){a.parentNode&&a.parentNode.selectedIndex;return
a.selected===!0},parent:function(a){return!!a.firstChild},empty:function(a){return!a.firstChild},has:function(a,b,c){return!!m(c[3],a).length},header:function(a){return/h\d/i.test(a.nodeName)},text:function(a){var
b=a.getAttribute("type"),c=a.type;return
a.nodeName.toLowerCase()==="input"&&"text"===c&&(b===c||
b===null)},radio:function(a){return
a.nodeName.toLowerCase()==="input"&&"radio"===a.type},checkbox:function(a){return
a.nodeName.toLowerCase()==="input"&&"checkbox"===a.type},file:function(a){return
a.nodeName.toLowerCase()==="input"&&"file"===a.type},password:function(a){return
a.nodeName.toLowerCase()==="input"&&"password"===a.type},submit:function(a){var
b=a.nodeName.toLowerCase();return(b==="input"||
b==="button")&&"submit"===a.type},image:function(a){return
a.nodeName.toLowerCase()==="input"&&"image"===a.type},reset:function(a){var
b=a.nodeName.toLowerCase();return(b==="input"||
b==="button")&&"reset"===a.type},button:function(a){var
b=a.nodeName.toLowerCase();return b==="input"&&"button"===a.type||
b==="button"},input:function(a){return/input|select|textarea|
button/i.test(a.nodeName)},focus:function(a){return
a===a.ownerDocument.activeElement}},setFilters:{first:function(a,b){return
b===0},last:function(a,b,c,d){return
b===d.length-1},even:function(a,b){return b%2===0},odd:function(a,b){return
b%2===1},lt:function(a,b,c){return b<c[3]-0},gt:function(a,b,c){return
b>c[3]-0},nth:function(a,b,c){return c[3]-0===b},eq:function(a,b,c){return
c[3]-0===b}},filter:{PSEUDO:function(a,b,c,d){var
e=b[1],f=o.filters[e];if(f)return
f(a,c,b,d);if(e==="contains")return(a.textContent||a.innerText||n([a])|
|"").indexOf(b[3])>=0;if(e==="not"){var g=b[3];for(var
h=0,i=g.length;h<i;h++)if(g[h]===a)return!1;return!0}m.error(e)},CHILD:function(a,b){var
c,e,f,g,h,i,j,k=b[1],l=a;switch(k){case"only":case"first":while(l=l.previousSibling)if(l.nodeType===1)return!1;if(k==="first")return!0;l=a;case"last":while(l=l.nextSibling)if(l.nodeType===1)return!1;return!0;case"nth":c=b[2],e=b[3];if(c===1&&e===0)return!0;f=b[0],g=a.parentNode;if(g&&(g[d]!==f|
|!a.nodeIndex)){i=0;for(l=g.firstChild;l;l=l.nextSibling)l.nodeType===1&&(l.nodeIndex=++i);g[d]=f}j=a.nodeIndex-e;return
c===0?j===0:j%c===0&&j/c>=0}},ID:function(a,b){return
a.nodeType===1&&a.getAttribute("id")===b},TAG:function(a,b){return
b==="*"&&a.nodeType===1|
|!!a.nodeName&&a.nodeName.toLowerCase()===b},CLASS:function(a,b){return(" "+(a.className|
|a.getAttribute("class"))+" ").indexOf(b)>-1},ATTR:function(a,b){var
c=b[1],d=m.attr?m.attr(a,c):o.attrHandle[c]?o.attrHandle[c](a):a[c]!=null?a[c]:a.getAttribute(c),e=d+"",f=b[2],g=b[4];return
d==null?f==="!=":!f&&m.attr?d!=null:f==="="?e===g:f==="*="?e.indexOf(g)>=0:f==="~="?(" "+e+" ").indexOf(g)>=0:g?f==="!="?e!==g:f==="^="?e.indexOf(g)===0:f==="$="?e.substr(e.length-g.length)===g:f==="|
="?e===g||
e.substr(0,g.length+1)===g+"-":!1:e&&d!==!1},POS:function(a,b,c,d){var
e=b[2],f=o.setFilters[e];if(f)return
f(a,c,b,d)}}},p=o.match.POS,q=function(a,b){return"\\"+(b-0+1)};for(var r
in o.match)o.match[r]=new
RegExp(o.match[r].source+/(?![^\[]*\])(?![^\(]*\))/.source),o.leftMatch[r]=new
RegExp(/(^(?:.|\r|
\n)*?)/.source+o.match[r].source.replace(/\\(\d+)/g,q));var
s=function(a,b){a=Array.prototype.slice.call(a,0);if(b){b.push.apply(b,a);return
b}return
a};try{Array.prototype.slice.call(c.documentElement.childNodes,0)[0].nodeType}catch(t){s=function(a,b){var
c=0,d=b||[];if(g.call(a)==="[object
Array]")Array.prototype.push.apply(d,a);else if(typeof
a.length=="number")for(var e=a.length;c<e;c++)d.push(a[c]);else
for(;a[c];c++)d.push(a[c]);return d}}var
u,v;c.documentElement.compareDocumentPosition?u=function(a,b){if(a===b){h=!0;return
0}if(!a.compareDocumentPosition||!b.compareDocumentPosition)return
a.compareDocumentPosition?-1:1;return
a.compareDocumentPosition(b)&4?-1:1}:(u=function(a,b){if(a===b){h=!0;return
0}if(a.sourceIndex&&b.sourceIndex)return a.sourceIndex-b.sourceIndex;var
c,d,e=[],f=[],g=a.parentNode,i=b.parentNode,j=g;if(g===i)return
v(a,b);if(!g)return-1;if(!i)return
1;while(j)e.unshift(j),j=j.parentNode;j=i;while(j)f.unshift(j),j=j.parentNode;c=e.length,d=f.length;for(var
k=0;k<c&&k<d;k++)if(e[k]!==f[k])return v(e[k],f[k]);return
k===c?v(a,f[k],-1):v(e[k],b,1)},v=function(a,b,c){if(a===b)return c;var
d=a.nextSibling;while(d){if(d===b)return-1;d=d.nextSibling}return
1}),function(){var a=c.createElement("div"),d="script"+(new
Date).getTime(),e=c.documentElement;a.innerHTML="<a
name='"+d+"'/>",e.insertBefore(a,e.firstChild),c.getElementById(d)&&(
o.find.ID=function(a,c,d){if(typeof
c.getElementById!="undefined"&&!d){var e=c.getElementById(a[1]);return
e?
e.id===a[1]||typeof
e.getAttributeNode!="undefined"&&e.getAttributeNode("id").nodeValue===a[1]?[e]:b:[]}},
o.filter.ID=function(a,b){var
c=typeof a.getAttributeNode!="undefined"&&a.getAttributeNode("id");return
a.nodeType===1&&c&&c.nodeValue===b}),e.removeChild(a),e=a=null}(),function(){var
a=c.createElement("div");a.appendChild(c.createComment("")),a.getElementsByTagName("*").length>0&&(o.find.TAG=function(a,b){var
c=b.getElementsByTagName(a[1]);if(a[1]==="*"){var d=[];for(var
e=0;c[e];e++)c[e].nodeType===1&&d.push(c[e]);c=d}return c}),a.innerHTML="<a
href='#'></a>",a.firstChild&&typeof
a.firstChild.getAttribute!="undefined"&&a.firstChild.getAttribute("href")!=="#"&&(o.attrHandle.href=function(a){return
a.getAttribute("href",2)}),a=null}(),c.querySelectorAll&&function(){var
a=m,b=c.createElement("div"),d="__sizzle__";b.innerHTML="<p
class='TEST'></p>";if(!b.querySelectorAll||
b.querySelectorAll(".TEST").length!==0){m=function(b,e,f,g){e=e||
c;if(!g&&!m.isXML(e)){var h=/^(\w+$)|^\.([\w\-]+$)|
^#([\w\-]+$)/.exec(b);if(h&&(e.nodeType===1||
e.nodeType===9)){if(h[1])return
s(e.getElementsByTagName(b),f);if(h[2]&&o.find.CLASS&&e.getElementsByClassName)return
s(e.getElementsByClassName(h[2]),f)}if(e.nodeType===9){if(b==="body"&&e.body)return
s([e.body],f);if(h&&h[3]){var i=e.getElementById(h[3]);if(!i|
|!i.parentNode)return s([],f);if(
i.id===h[3])return s([i],f)}try{return
s(e.querySelectorAll(b),f)}catch(j){}}else
if(e.nodeType===1&&e.nodeName.toLowerCase()!=="object"){var
k=e,l=e.getAttribute("id"),n=l||
d,p=e.parentNode,q=/^\s*[+~]/.test(b);l?n=n.replace(/'/g,"\\$&"):e.setAttribute("id",n),q&&p&&(e=e.parentNode);try{if(!q|
|p)return s(e.querySelectorAll("[id='"+n+"'] "+b),f)}catch(r){}finally{l||
k.removeAttribute("id")}}}return a(b,e,f,g)};for(var e in
a)m[e]=a[e];b=null}}(),function(){var
a=c.documentElement,b=a.matchesSelector||a.mozMatchesSelector||
a.webkitMatchesSelector||a.msMatchesSelector;if(b){var
d=!b.call(c.createElement("div"),"div"),e=!1;try{b.call(c.documentElement,"[test!='']:sizzle")}catch(f){e=!0}m.matchesSelector=function(a,c){c=c.replace(/\=\s*([^'"\]]*)\s*\]/g,"='$1']");if(!m.isXML(a))try{if(e|
|!o.match.PSEUDO.test(c)&&!/!=/.test(c)){var f=b.call(a,c);if(f||!d||
a.document&&a.document.nodeType!==11)return f}}catch(g){}return
m(c,null,null,[a]).length>0}}}(),function(){var
a=c.createElement("div");a.innerHTML="<div class='test e'></div><div
class='test'></div>";if(!!a.getElementsByClassName&&a.getElementsByClassName("e").length!==0){a.lastChild.className="e";if(a.getElementsByClassName("e").length===1)return;o.order.splice(1,0,"CLASS"),o.find.CLASS=function(a,b,c){if(typeof
b.getElementsByClassName!="undefined"&&!c)return
b.getElementsByClassName(a[1])},a=null}}(),c.documentElement.contains?m.contains=function(a,b){return
a!==b&&(a.contains?a.contains(b):!0)}:c.documentElement.compareDocumentPosition?m.contains=function(a,b){return!!(a.compareDocumentPosition(b)&16)}:m.contains=function(){return!1},m.isXML=function(a){var
b=(a?a.ownerDocument||a:0).documentElement;return
b?b.nodeName!=="HTML":!1};var y=function(a,b,c){var
d,e=[],f="",g=b.nodeType?[b]:b;while(d=o.match.PSEUDO.exec(a))f+=d[0],a=a.replace(o.match.PSEUDO,"");a=o.relative[a]?a+"*":a;for(var
h=0,i=g.length;h<i;h++)m(a,g[h],e,c);return
m.filter(f,e)};m.attr=f.attr,m.selectors.attrMap={},f.find=m,f.expr=m.selectors,f.expr[":"]=f.expr.filters,f.unique=m.uniqueSort,f.text=m.getText,f.isXMLDoc=m.isXML,f.contains=m.contains}();var
L=/Until$/,M=/^(?:parents|prevUntil|
prevAll)/,N=/,/,O=/^.[^:#\[\.,]*$/,P=Array.prototype.slice,Q=f.expr.match.POS,R={children:!0,contents:!0,next:!0,prev:!0};f.fn.extend({find:function(a){var
b=this,c,d;if(typeof a!="string")return
f(a).filter(function(){for(c=0,d=b.length;c<d;c++)if(f.contains(b[c],this))return!0});var
e=this.pushStack("","find",a),g,h,i;for(c=0,d=this.length;c<d;c++){g=e.length,f.find(a,this[c],e);if(c>0)for(h=g;h<e.length;h++)for(i=0;i<g;i++)if(e[i]===e[h]){e.splice(h--,1);break}}return
e},has:function(a){var b=f(a);return this.filter(function(){for(var
a=0,c=b.length;a<c;a++)if(f.contains(this,b[a]))return!0})},not:function(a){return
this.pushStack(T(this,a,!1),"not",a)},filter:function(a){return
this.pushStack(T(this,a,!0),"filter",a)},is:function(a){return!!a&&(typeof
a=="string"?Q.test(a)?f(a,this.context).index(this[0])>=0:f.filter(a,this).length>0:this.filter(a).length>0)},closest:function(a,b){var
c=[],d,e,g=this[0];if(f.isArray(a)){var
h=1;while(g&&g.ownerDocument&&g!==b){for(d=0;d<a.length;d++)f(g).is(a[d])&&c.push({selector:a[d],elem:g,level:h});g=g.parentNode,h++}return
c}var i=Q.test(a)||typeof a!="string"?f(a,b||
this.context):0;for(d=0,e=this.length;d<e;d++){g=this[d];while(g){if(i?i.index(g)>-1:f.find.matchesSelector(g,a)){c.push(g);break}g=g.parentNode;if(!g|
|!g.ownerDocument||g===b||
g.nodeType===11)break}}c=c.length>1?f.unique(c):c;return
this.pushStack(c,"closest",a)},index:function(a){if(!a)return
this[0]&&this[0].parentNode?this.prevAll().length:-1;if(typeof
a=="string")return f.inArray(this[0],f(a));return
f.inArray(a.jquery?a[0]:a,this)},add:function(a,b){var c=typeof
a=="string"?f(a,b):f.makeArray(a&&a.nodeType?[a]:a),d=f.merge(this.get(),c);return
this.pushStack(S(c[0])||S(d[0])?d:f.unique(d))},andSelf:function(){return
this.add(this.prevObject)}}),f.each({parent:function(a){var
b=a.parentNode;return b&&b.nodeType!==11?b:null},parents:function(a){return
f.dir(a,"parentNode")},parentsUntil:function(a,b,c){return
f.dir(a,"parentNode",c)},next:function(a){return
f.nth(a,2,"nextSibling")},prev:function(a){return
f.nth(a,2,"previousSibling")},nextAll:function(a){return
f.dir(a,"nextSibling")},prevAll:function(a){return
f.dir(a,"previousSibling")},nextUntil:function(a,b,c){return
f.dir(a,"nextSibling",c)},prevUntil:function(a,b,c){return
f.dir(a,"previousSibling",c)},siblings:function(a){return
f.sibling(a.parentNode.firstChild,a)},children:function(a){return
f.sibling(a.firstChild)},contents:function(a){return
f.nodeName(a,"iframe")?a.contentDocument||
a.contentWindow.document:f.makeArray(a.childNodes)}},function(a,b){f.fn[a]=function(c,d){var
e=f.map(this,b,c);L.test(a)||(d=c),d&&typeof
d=="string"&&(e=f.filter(d,e)),e=this.length>1&&!R[a]?f.unique(e):e,(this.length>1|
|N.test(d))&&M.test(a)&&(e=e.reverse());return
this.pushStack(e,a,P.call(arguments).join(","))}}),f.extend({filter:function(a,b,c){c&&(a=":not("+a+")");return
b.length===1?f.find.matchesSelector(b[0],a)?[b[0]]:[]:f.find.matches(a,b)},dir:function(a,c,d){var
e=[],g=a[c];while(g&&g.nodeType!==9&&(d===b||g.nodeType!==1|
|!f(g).is(d)))g.nodeType===1&&e.push(g),g=g[c];return
e},nth:function(a,b,c,d){b=b||1;var
e=0;for(;a;a=a[c])if(a.nodeType===1&&++e===b)break;return
a},sibling:function(a,b){var
c=[];for(;a;a=a.nextSibling)a.nodeType===1&&a!==b&&c.push(a);return
c}});var V="abbr|article|aside|audio|canvas|datalist|details|figcaption|
figure|footer|header|hgroup|mark|meter|nav|output|progress|section|summary|
time|video",W=/ jQuery\d+="(?:\d+|null)"/g,X=/^\s+/,Y=/<(?!area|br|col|
embed|hr|img|input|link|meta|
param)(([\w:]+)[^>]*)\/>/ig,Z=/<([\w:]+)/,$=/<tbody/i,_=/<|
&#?\w+;/,ba=/<(?:script|style)/i,bb=/<(?:script|object|embed|option|
style)/i,bc=new RegExp("<(?:"+V+")","i"),bd=/checked\s*(?:[^=]|
=\s*.checked.)/i,be=/\/(java|ecma)script/i,bf=/^\s*<!(?:\[CDATA\[|
\-\-)/,bg={option:[1,"<select
multiple='multiple'>","</select>"],legend:[1,"<fieldset>","</fieldset>"],thead:[1,"<table>","</table>"],tr:[2,"<table><tbody>","</tbody></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],col:[2,"<table><tbody></tbody><colgroup>","</colgroup></table>"],area:[1,"<map>","</map>"],_default:[0,"",""]},bh=U(c);bg.optgroup=bg.option,bg.tbody=bg.tfoot=bg.colgroup=bg.caption=bg.thead,
bg.th=
bg.td,f.support.htmlSerialize|
|
(bg._default=[1,"div<div>","</div>"]),f.fn.extend({text:function(a){if(f.isFunction(a))return
this.each(function(b){var
c=f(this);c.text(a.call(this,b,c.text()))});if(typeof
a!="object"&&a!==b)return
this.empty().append((this[0]&&this[0].ownerDocument||
c).createTextNode(a));return
f.text(this)},wrapAll:function(a){if(f.isFunction(a))return
this.each(function(b){f(this).wrapAll(a.call(this,b))});if(this[0]){var
b=f(a,this[0].ownerDocument).eq(0).clone(!0);this[0].parentNode&&b.insertBefore(this[0]),b.map(function(){var
a=this;while(a.firstChild&&a.firstChild.nodeType===1)a=a.firstChild;return
a}).append(this)}return
this},wrapInner:function(a){if(f.isFunction(a))return
this.each(function(b){f(this).wrapInner(a.call(this,b))});return
this.each(function(){var
b=f(this),c=b.contents();c.length?c.wrapAll(a):b.append(a)})},wrap:function(a){var
b=f.isFunction(a);return
this.each(function(c){f(this).wrapAll(b?a.call(this,c):a)})},unwrap:function(){return
this.parent().each(function(){f.nodeName(this,"body")||
f(this).replaceWith(this.childNodes)}).end()},append:function(){return
this.domManip(arguments,!0,function(a){this.nodeType===1&&this.appendChild(a)})},prepend:function(){return
this.domManip(arguments,!0,function(a){this.nodeType===1&&this.insertBefore(a,this.firstChild)})},before:function(){if(this[0]&&this[0].parentNode)return
this.domManip(arguments,!1,function(a){this.parentNode.insertBefore(a,this)});if(arguments.length){var
a=f.clean(arguments);a.push.apply(a,this.toArray());return
this.pushStack(a,"before",arguments)}},after:function(){if(this[0]&&this[0].parentNode)return
this.domManip(arguments,!1,function(a){this.parentNode.insertBefore(a,this.nextSibling)});if(arguments.length){var
a=this.pushStack(this,"after",arguments);a.push.apply(a,f.clean(arguments));return
a}},remove:function(a,b){for(var c=0,d;(d=this[c])!=null;c++)if(!a||
f.filter(a,[d]).length)!b&&d.nodeType===1&&(f.cleanData(d.getElementsByTagName("*")),f.cleanData([d])),d.parentNode&&d.parentNode.removeChild(d);return
this},empty:function()
+{for(var
a=0,b;(b=this[a])!=null;a++){b.nodeType===1&&f.cleanData(b.getElementsByTagName("*"));while(b.firstChild)b.removeChild(b.firstChild)}return
this},clone:function(a,b){a=a==null?!1:a,b=b==null?a:b;return
this.map(function(){return
f.clone(this,a,b)})},html:function(a){if(a===b)return
this[0]&&this[0].nodeType===1?this[0].innerHTML.replace(W,""):null;if(typeof
a=="string"&&!ba.test(a)&&(f.support.leadingWhitespace|
|!X.test(a))&&!bg[(Z.exec(a)||
["",""])[1].toLowerCase()]){a=a.replace(Y,"<$1></$2>");try{for(var
c=0,d=this.length;c<d;c++)this[c].nodeType===1&&(f.cleanData(this[c].getElementsByTagName("*")),this[c].innerHTML=a)}catch(e){this.empty().append(a)}}else
f.isFunction(a)?this.each(function(b){var
c=f(this);c.html(a.call(this,b,c.html()))}):this.empty().append(a);return
this},replaceWith:function(a){if(this[0]&&this[0].parentNode){if(f.isFunction(a))return
this.each(function(b){var
c=f(this),d=c.html();c.replaceWith(a.call(this,b,d))});typeof
a!="string"&&(a=f(a).detach());return this.each(function(){var
b=this.nextSibling,c=this.parentNode;f(this).remove(),b?f(b).before(a):f(c).append(a)})}return
this.length?this.pushStack(f(f.isFunction(a)?a():a),"replaceWith",a):this},detach:function(a){return
this.remove(a,!0)},domManip:function(a,c,d){var
e,g,h,i,j=a[0],k=[];if(!f.support.checkClone&&arguments.length===3&&typeof
j=="string"&&bd.test(j))return
this.each(function(){f(this).domManip(a,c,d,!0)});if(f.isFunction(j))return
this.each(function(e){var
g=f(this);a[0]=j.call(this,e,c?g.html():b),g.domManip(a,c,d)});if(this[0]){i=j&&j.parentNode,f.support.parentNode&&i&&i.nodeType===11&&i.childNodes.length===this.length?e={fragment:i}:e=f.buildFragment(a,this,k),h=e.fragment,h.childNodes.length===1?g=h=h.firstChild:g=h.firstChild;if(g){c=c&&f.nodeName(g,"tr");for(var
l=0,m=this.length,n=m-1;l<m;l++)d.call(c?bi(this[l],g):this[l],e.cacheable||
m>1&&l<n?f.clone(h,!0,!0):h)}k.length&&f.each(k,bp)}return
this}}),f.buildFragment=function(a,b,d){var
e,g,h,i,j=a[0];b&&b[0]&&(i=b[0].ownerDocument||
b[0]),i.createDocumentFragment||(i=c),a.length===1&&typeof
j=="string"&&j.length<512&&i===c&&j.charAt(0)==="<"&&!bb.test(j)&&(f.support.checkClone|
|!bd.test(j))&&(f.support.html5Clone|
|!bc.test(j))&&(g=!0,h=f.fragments[j],h&&h!==1&&(e=h)),e||
(e=i.createDocumentFragment(),f.clean(a,i,e,d)),g&&(f.fragments[j]=h?e:1);return{fragment:e,cacheable:g}},f.fragments={},f.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(a,b){f.fn[a]=function(c){var
d=[],e=f(c),g=this.length===1&&this[0].parentNode;if(g&&g.nodeType===11&&g.childNodes.length===1&&e.length===1){e[b](this[0]);return
this}for(var h=0,i=e.length;h<i;h++){var
j=(h>0?this.clone(!0):this).get();f(e[h])[b](j),d=d.concat(j)}return
this.pushStack(d,a,e.selector)}}),f.extend({clone:function(a,b,c){var
d,e,g,h=f.support.html5Clone|
|!bc.test("<"+a.nodeName)?a.cloneNode(!0):bo(a);if((!f.support.noCloneEvent|
|!f.support.noCloneChecked)&&(a.nodeType===1||
a.nodeType===11)&&!f.isXMLDoc(a)){bk(a,h),d=bl(a),e=bl(h);for(g=0;d[g];++g)e[g]&&bk(d[g],e[g])}if(b){bj(a,h);if(c){d=bl(a),e=bl(h);for(g=0;d[g];++g)bj(d[g],e[g])}}d=e=null;return
h},clean:function(a,b,d,e){var g;b=b||c,typeof
b.createElement=="undefined"&&(b=b.ownerDocument||b[0]&&b[0].ownerDocument||
c);var h=[],i;for(var j=0,k;(k=a[j])!=null;j++){typeof
k=="number"&&(k+="");if(!k)continue;if(typeof
k=="string")if(!_.test(k))k=b.createTextNode(k);else{k=k.replace(Y,"<$1></$2>");var
l=(Z.exec(k)||["",""])[1].toLowerCase(),m=bg[l]||
bg._default,n=m[0],o=b.createElement("div");b===c?bh.appendChild(o):U(b).appendChild(o),o.innerHTML=m[1]+k+m[2];while(n--)o=o.lastChild;if(!f.support.tbody){var
p=$.test(k),q=l==="table"&&!p?o.firstChild&&o.firstChild.childNodes:m[1]==="<table>"&&!p?o.childNodes:[];for(i=q.length-1;i>=0;--i)f.nodeName(q[i],"tbody")&&!q[i].childNodes.length&&q[i].parentNode.removeChild(q[i])}!f.support.leadingWhitespace&&X.test(k)&&o.insertBefore(b.createTextNode(X.exec(k)[0]),o.firstChild),k=o.childNodes}var
r;if(!f.support.appendChecked)if(k[0]&&typeof
(r=k.length)=="number")for(i=0;i<r;i++)bn(k[i]);else
bn(k);k.nodeType?h.push(k):h=f.merge(h,k)}if(d){g=function(a){return!a.type|
|
be.test(a.type)};for(j=0;h[j];j++)if(e&&f.nodeName(h[j],"script")&&(!h[j].type|
|
h[j].type.toLowerCase()==="text/javascript"))e.push(h[j].parentNode?h[j].parentNode.removeChild(h[j]):h[j]);else{if(h[j].nodeType===1){var
s=f.grep(h[j].getElementsByTagName("script"),g);h.splice.apply(h,[j+1,0].concat(s))}d.appendChild(h[j])}}return
h},cleanData:function(a){var
b,c,d=f.cache,e=f.event.special,g=f.support.deleteExpando;for(var
h=0,i;(i=a[h])!=null;h++){if(i.nodeName&&f.noData[i.nodeName.toLowerCase()])continue;c=i[f.expando];if(c){b=d[c];if(b&&b.events){for(var
j in
b.events)e[j]?f.event.remove(i,j):f.removeEvent(i,j,b.handle);b.handle&&(b.handle.elem=null)}g?delete
i[f.expando]:i.removeAttribute&&i.removeAttribute(f.expando),delete
d[c]}}}});var bq=/alpha\([^)]*\)/i,br=/opacity=([^)]*)/,bs=/([A-Z]|
^ms)/g,bt=/^-?\d+(?:px)?$/i,bu=/^-?\d/,bv=/^([\-+])=([\-+.\de]+)/,bw={position:"absolute",visibility:"hidden",display:"block"},bx=["Left","Right"],by=["Top","Bottom"],bz,bA,bB;f.fn.css=function(a,c){if(arguments.length===2&&c===b)return
this;return f.access(this,a,c,!0,function(a,c,d){return
d!==b?f.style(a,c,d):f.css(a,c)})},f.extend({cssHooks:{opacity:{get:function(a,b){if(b){var
c=bz(a,"opacity","opacity");return c===""?"1":c}return
a.style.opacity}}},cssNumber:{fillOpacity:!0,fontWeight:!0,lineHeight:!0,opacity:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{"float":f.support.cssFloat?"cssFloat":"styleFloat"},style:function(a,c,d,e){if(!!a&&a.nodeType!==3&&a.nodeType!==8&&!!a.style){var
g,h,i=f.camelCase(c),j=a.style,k=f.cssHooks[i];c=f.cssProps[i]||
i;if(d===b){if(k&&"get"in k&&(g=k.get(a,!1,e))!==b)return g;return
j[c]}h=typeof
d,h==="string"&&(g=bv.exec(d))&&(d=+(g[1]+1)*+g[2]+parseFloat(f.css(a,c)),h="number");if(d==null|
|
h==="number"&&isNaN(d))return;h==="number"&&!f.cssNumber[i]&&(d+="px");if(!k|
|!("set"in k)||
(d=k.set(a,d))!==b)try{j[c]=d}catch(l){}}},css:function(a,c,d){var
e,g;c=f.camelCase(c),g=f.cssHooks[c],c=f.cssProps[c]||
c,c==="cssFloat"&&(c="float");if(g&&"get"in g&&(e=g.get(a,!0,d))!==b)return
e;if(bz)return bz(a,c)},swap:function(a,b,c){var d={};for(var e in
b)d[e]=a.style[e],a.style[e]=b[e];c.call(a);for(e in
b)a.style[e]=d[e]}}),f.curCSS=f.css,f.each(["height","width"],function(a,b){f.cssHooks[b]={get:function(a,c,d){var
e;if(c){if(a.offsetWidth!==0)return
bC(a,b,d);f.swap(a,bw,function(){e=bC(a,b,d)});return
e}},set:function(a,b){if(!bt.test(b))return
b;b=parseFloat(b);if(b>=0)return b+"px"}}}),f.support.opacity||
(f.cssHooks.opacity={get:function(a,b){return
br.test((b&&a.currentStyle?a.currentStyle.filter:a.style.filter)|
|"")?parseFloat(RegExp.$1)/100+"":b?"1":""},set:function(a,b){var
c=a.style,d=a.currentStyle,e=f.isNumeric(b)?"alpha(opacity="+b*100+")":"",g=d&&d.filter|
|c.filter|
|"";c.zoom=1;if(b>=1&&f.trim(g.replace(bq,""))===""){c.removeAttribute("filter");if(d&&!d.filter)return}c.filter=bq.test(g)?g.replace(bq,e):g+" "+e}}),f(function(){f.support.reliableMarginRight|
|(f.cssHooks.marginRight={get:function(a,b){var
c;f.swap(a,{display:"inline-block"},function(){b?c=bz(a,"margin-right","marginRight"):c=a.style.marginRight});return
c}})}),c.defaultView&&c.defaultView.getComputedStyle&&(bA=function(a,b){var
c,d,e;b=b.replace(bs,"-$1").toLowerCase(),(d=a.ownerDocument.defaultView)&&(e=d.getComputedStyle(a,null))&&(c=e.getPropertyValue(b),c===""&&!f.contains(a.ownerDocument.documentElement,a)&&(c=f.style(a,b)));return
c}),c.documentElement.currentStyle&&(bB=function(a,b){var
c,d,e,f=a.currentStyle&&a.currentStyle[b],g=a.style;f===null&&g&&(e=g[b])&&(f=e),!bt.test(f)&&bu.test(f)&&(c=g.left,d=a.runtimeStyle&&a.runtimeStyle.left,d&&(a.runtimeStyle.left=a.currentStyle.left),g.left=b==="fontSize"?"1em":f|
|0,f=g.pixelLeft+"px",g.left=c,d&&(a.runtimeStyle.left=d));return
f===""?"auto":f}),bz=bA||
bB,f.expr&&f.expr.filters&&(f.expr.filters.hidden=function(a){var
b=a.offsetWidth,c=a.offsetHeight;return b===0&&c===0|
|!f.support.reliableHiddenOffsets&&(a.style&&a.style.display||
f.css(a,"display"))==="none"},f.expr.filters.visible=function(a){return!f.expr.filters.hidden(a)});var
bD=/%20/g,bE=/\[\]$/,bF=/\r?\n/g,bG=/#.*$/,bH=/^(.*?):[
\t]*([^\r\n]*)\r?$/mg,bI=/^(?:color|date|datetime|datetime-local|email|
hidden|month|number|password|range|search|tel|text|time|url|
week)$/i,bJ=/^(?:about|app|app\-storage|.+\-extension|file|res|
widget):$/,bK=/^(?:GET|
HEAD)$/,bL=/^\/\//,bM=/\?/,bN=/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi,bO=/^(?:select|
textarea)/i,bP=/\s+/,bQ=/([?&])_=[^&]*/,bR=/^([\w\+\.\-]+:)(?:\/\/([^\/?#:]*)(?::(\d+))?)?/,bS=f.fn.load,bT={},bU={},bV,bW,bX=["*/"]+["*"];try{bV=e.href}catch(bY){bV=c.createElement("a"),bV.href="",bV=bV.href}bW=bR.exec(bV.toLowerCase())|
|[],f.fn.extend({load:function(a,c,d){if(typeof a!="string"&&bS)return
bS.apply(this,arguments);if(!this.length)return this;var
e=a.indexOf(" ");if(e>=0){var g=a.slice(e,a.length);a=a.slice(0,e)}var
h="GET";c&&(f.isFunction(c)?(d=c,c=b):typeof
c=="object"&&(c=f.param(c,f.ajaxSettings.traditional),h="POST"));var
i=this;f.ajax({url:a,type:h,dataType:"html",data:c,complete:function(a,b,c){c=a.responseText,a.isResolved()&&(a.done(function(a){c=a}),i.html(g?f("<div>").append(c.replace(bN,"")).find(g):c)),d&&i.each(d,[c,b,a])}});return
this},serialize:function(){return
f.param(this.serializeArray())},serializeArray:function(){return
this.map(function(){return
this.elements?f.makeArray(this.elements):this}).filter(function(){return
this.name&&!this.disabled&&(this.checked||bO.test(this.nodeName)||
bI.test(this.type))}).map(function(a,b){var c=f(this).val();return
c==null?null:f.isArray(c)?f.map(c,function(a,c){return{name:
b.name,value:a.replace(bF,"\r\n")}}):{name:
b.name,value:c.replace(bF,"\r\n")}}).get()}}),f.each("ajaxStart
ajaxStop ajaxComplete ajaxError ajaxSuccess
ajaxSend".split(" "),function(a,b){f.fn[b]=function(a){return
this.on(b,a)}}),f.each(["get","post"],function(a,c){f[c]=function(a,d,e,g){f.isFunction(d)&&(g=g|
|e,e=d,d=b);return
f.ajax({type:c,url:a,data:d,success:e,dataType:g})}}),f.extend({getScript:function(a,c){return
f.get(a,b,c,"script")},getJSON:function(a,b,c){return
f.get(a,b,c,"json")},ajaxSetup:function(a,b){b?b_(a,f.ajaxSettings):(b=a,a=f.ajaxSettings),b_(a,b);return
a},ajaxSettings:{url:bV,isLocal:bJ.test(bW[1]),global:!0,type:"GET",contentType:"application/x-www-form-urlencoded",processData:!0,async:!0,accepts:{xml:"application/xml,
text/xml",html:"text/html",text:"text/plain",json:"application/json,
text/javascript","*":bX},contents:{xml:/xml/,html:/html/,json:/json/},responseFields:{xml:"responseXML",text:"responseText"},converters:{"*
text":a.String,"text html":!0,"text json":f.parseJSON,"text
xml":f.parseXML},flatOptions:{context:!0,url:!0}},ajaxPrefilter:bZ(bT),ajaxTransport:bZ(bU),ajax:function(a,c){function
w(a,c,l,m){if(s!==2){s=2,q&&clearTimeout(q),p=b,n=m|
|"",v.readyState=a>0?4:0;var o,r,u,w=c,x=l?cb(d,v,l):b,y,z;if(a>=200&&a<300|
|
a===304){if(d.ifModified){if(y=v.getResponseHeader("Last-Modified"))f.lastModified[k]=y;if(z=v.getResponseHeader("Etag"))f.etag[k]=z}if(a===304)w="notmodified",o=!0;else
try{r=cc(d,x),w="success",o=!0}catch(A){w="parsererror",u=A}}else{u=w;if(!w|
|a)w="error",a<0&&(a=0)}v.status=a,v.statusText=""+(c||
w),o?h.resolveWith(e,[r,w,v]):h.rejectWith(e,[v,w,u]),v.statusCode(j),j=b,t&&g.trigger("ajax"+(o?"Success":"Error"),[v,d,o?r:u]),i.fireWith(e,[v,w]),t&&(g.trigger("ajaxComplete",[v,d]),--f.active|
|f.event.trigger("ajaxStop"))}}typeof a=="object"&&(c=a,a=b),c=c||{};var
d=f.ajaxSetup({},c),e=d.context||d,g=e!==d&&(e.nodeType||e instanceof
f)?f(e):f.event,h=f.Deferred(),i=f.Callbacks("once memory"),j=d.statusCode||
{},k,l={},m={},n,o,p,q,r,s=0,t,u,v={readyState:0,setRequestHeader:function(a,b){if(!s){var
c=a.toLowerCase();a=m[c]=m[c]||a,l[a]=b}return
this},getAllResponseHeaders:function(){return
s===2?n:null},getResponseHeader:function(a){var
c;if(s===2){if(!o){o={};while(c=bH.exec(n))o[c[1].toLowerCase()]=c[2]}c=o[a.toLowerCase()]}return
c===b?null:c},overrideMimeType:function(a){s||(d.mimeType=a);return
this},abort:function(a){a=a||"abort",p&&p.abort(a),w(0,a);return
this}};h.promise(v),v.success=v.done,v.error=v.fail,v.complete=i.add,v.statusCode=function(a){if(a){var
b;if(s<2)for(b in a)j[b]=[j[b],a[b]];else b=a[v.status],v.then(b,b)}return
this},d.url=((a||
d.url)+"").replace(bG,"").replace(bL,bW[1]+"//"),d.dataTypes=f.trim(d.dataType|
|"*").toLowerCase().split(bP),d.crossDomain==null&&(r=bR.exec(d.url.toLowerCase()),d.crossDomain=!(!r|
|r[1]==bW[1]&&r[2]==bW[2]&&(r[3]||(r[1]==="http:"?80:443))==(bW[3]||
(bW[1]==="http:"?80:443)))),d.data&&d.processData&&typeof
d.data!="string"&&(d.data=f.param(d.data,d.traditional)),b$(bT,d,c,v);if(s===2)return!1;t=d.global,d.type=d.type.toUpperCase(),d.hasContent=!bK.test(d.type),t&&f.active++===0&&f.event.trigger("ajaxStart");if(!d.hasContent){d.data&&(d.url+=(bM.test(d.url)?"&":"?")+d.data,delete
d.data),k=d.url;if(d.cache===!1){var
x=f.now(),y=d.url.replace(bQ,"$1_="+x);d.url=y+(y===d.url?(bM.test(d.url)?"&":"?")+"_="+x:"")}}(d.data&&d.hasContent&&d.contentType!==!1|
|
c.contentType)&&v.setRequestHeader("Content-Type",d.contentType),d.ifModified&&(k=k|
|
d.url,f.lastModified[k]&&v.setRequestHeader("If-Modified-Since",f.lastModified[k]),f.etag[k]&&v.setRequestHeader("If-None-Match",f.etag[k])),v.setRequestHeader("Accept",d.dataTypes[0]&&d.accepts[d.dataTypes[0]]?d.accepts[d.dataTypes[0]]+(d.dataTypes[0]!=="*"?", "+bX+";
q=0.01":""):d.accepts["*"]);for(u in
d.headers)v.setRequestHeader(u,d.headers[u]);if(d.beforeSend&&(d.beforeSend.call(e,v,d)===!1|
|s===2)){v.abort();return!1}for(u
in{success:1,error:1,complete:1})v[u](d[u]);p=b$(bU,d,c,v);if(!p)w(-1,"No
Transport");else{v.readyState=1,t&&g.trigger("ajaxSend",[v,d]),d.async&&d.timeout>0&&(q=setTimeout(function(){v.abort("timeout")},d.timeout));try{s=1,p.send(l,w)}catch(z){if(s<2)w(-1,z);else
throw z}}return v},param:function(a,c){var
d=[],e=function(a,b){b=f.isFunction(b)?b():b,d[d.length]=encodeURIComponent(a)+"="+encodeURIComponent(b)};c===b&&(c=f.ajaxSettings.traditional);if(f.isArray(a)|
|
a.jquery&&!f.isPlainObject(a))f.each(a,function(){e(
this.name,this.value)});else
for(var g in a)ca(g,a[g],c,e);return
d.join("&").replace(bD,"+")}}),f.extend({active:0,lastModified:{},etag:{}});var
cd=f.now(),ce=/(\=)\?(&|$)|
\?\?/i;f.ajaxSetup({jsonp:"callback",jsonpCallback:function(){return
f.expando+"_"+cd++}}),f.ajaxPrefilter("json jsonp",function(b,c,d){var
e=b.contentType==="application/x-www-form-urlencoded"&&typeof
b.data=="string";if(b.dataTypes[0]==="jsonp"||b.jsonp!==!1&&(ce.test(b.url)|
|e&&ce.test(b.data))){var
g,h=b.jsonpCallback=f.isFunction(b.jsonpCallback)?b.jsonpCallback():b.jsonpCallback,i=a[h],j=b.url,k=b.data,l="$1"+h+"$2";b.jsonp!==!1&&(j=j.replace(ce,l),b.url===j&&(e&&(k=k.replace(ce,l)),b.data===k&&(j+=(/\?/.test(j)?"&":"?")+b.jsonp+"="+h))),b.url=j,b.data=k,a[h]=function(a){g=[a]},d.always(function(){a[h]=i,g&&f.isFunction(i)&&a[h](g[0])}),b.converters["script
json"]=function(){g||f.error(h+" was not called");return
g[0]},b.dataTypes[0]="json";return"script"}}),f.ajaxSetup({accepts:{script:"text/javascript,
application/javascript, application/ecmascript,
application/x-ecmascript"},contents:{script:/javascript|
ecmascript/},converters:{"text script":function(a){f.globalEval(a);return
a}}}),f.ajaxPrefilter("script",function(a){a.cache===b&&(a.cache=!1),a.crossDomain&&(a.type="GET",a.global=!1)}),f.ajaxTransport("script",function(a){if(a.crossDomain){var
d,e=c.head||c.getElementsByTagName("head")[0]||
c.documentElement;return{send:function(f,g){d=c.createElement("script"),d.async="async",a.scriptCharset&&(d.charset=a.scriptCharset),d.src=a.url,d.onload=d.onreadystatechange=function(a,c){if(c|
|!d.readyState||/loaded|
complete/.test(d.readyState))d.onload=d.onreadystatechange=null,e&&d.parentNode&&e.removeChild(d),d=b,c|
|
g(200,"success")},e.insertBefore(d,e.firstChild)},abort:function(){d&&d.onload(0,1)}}}});var
cf=a.ActiveXObject?function(){for(var a in
ch)ch[a](0,1)}:!1,cg=0,ch;f.ajaxSettings.xhr=a.ActiveXObject?function(){return!this.isLocal&&ci()|
|
cj()}:ci,function(a){f.extend(f.support,{ajax:!!a,cors:!!a&&"withCredentials"in
a})}(f.ajaxSettings.xhr()),f.support.ajax&&f.ajaxTransport(function(c){if(!c.crossDomain|
|f.support.cors){var d;return{send:function(e,g){var
h=c.xhr(),i,j;c.username?h.open(c.type,c.url,c.async,c.username,c.password):h.open(c.type,c.url,c.async);if(c.xhrFields)for(j
in
c.xhrFields)h[j]=c.xhrFields[j];c.mimeType&&h.overrideMimeType&&h.overrideMimeType(c.mimeType),!c.crossDomain&&!e["X-Requested-With"]&&(e["X-Requested-With"]="XMLHttpRequest");try{for(j
in e)h.setRequestHeader(j,e[j])}catch(k){}h.send(c.hasContent&&c.data||
null),d=function(a,e){var j,k,l,m,n;try{if(d&&(e||
h.readyState===4)){d=b,i&&(h.onreadystatechange=f.noop,cf&&delete
ch[i]);if(e)h.readyState!==4&&h.abort();else{j=h.status,l=h.getAllResponseHeaders(),m={},n=h.responseXML,n&&n.documentElement&&(m.xml=n),m.text=h.responseText;try{k=h.statusText}catch(o){k=""}!j&&c.isLocal&&!c.crossDomain?j=m.text?200:404:j===1223&&(j=204)}}}catch(p){e|
|g(-1,p)}m&&g(j,k,m,l)},!c.async||h.readyState===4?d():(i=++cg,cf&&(ch||
(ch={},f(a).unload(cf)),ch[i]=d),h.onreadystatechange=d)},abort:function(){d&&d(0,1)}}}});var
ck={},cl,cm,cn=/^(?:toggle|show|
hide)$/,co=/^([+\-]=)?([\d+.\-]+)([a-z%]*)$/i,cp,cq=[["height","marginTop","marginBottom","paddingTop","paddingBottom"],["width","marginLeft","marginRight","paddingLeft","paddingRight"],["opacity"]],cr;f.fn.extend({show:function(a,b,c){var
d,e;if(a||a===0)return this.animate(cu("show",3),a,b,c);for(var
g=0,h=this.length;g<h;g++)d=this[g],d.style&&(e=d.style.display,!f._data(d,"olddisplay")&&e==="none"&&(e=d.style.display=""),e===""&&f.css(d,"display")==="none"&&f._data(d,"olddisplay",cv(d.nodeName)));for(g=0;g<h;g++){d=this[g];if(d.style){e=d.style.display;if(e===""|
|e==="none")d.style.display=f._data(d,"olddisplay")||""}}return
this},hide:function(a,b,c){if(a||a===0)return
this.animate(cu("hide",3),a,b,c);var
d,e,g=0,h=this.length;for(;g<h;g++)d=this[g],d.style&&(e=f.css(d,"display"),e!=="none"&&!f._data(d,"olddisplay")&&f._data(d,"olddisplay",e));for(g=0;g<h;g++)this[g].style&&(this[g].style.display="none");return
this},_toggle:f.fn.toggle,toggle:function(a,b,c){var d=typeof
a=="boolean";f.isFunction(a)&&f.isFunction(b)?this._toggle.apply(this,arguments):a==null|
|d?this.each(function(){var
b=d?a:f(this).is(":hidden");f(this)[b?"show":"hide"]()}):this.animate(cu("toggle",3),a,b,c);return
this},fadeTo:function(a,b,c,d){return
this.filter(":hidden").css("opacity",0).show().end().animate({opacity:b},a,c,d)},animate:function(a,b,c,d){function
g(){e.queue===!1&&f._mark(this);var
b=f.extend({},e),c=this.nodeType===1,d=c&&f(this).is(":hidden"),g,h,i,j,k,l,m,n,o;b.animatedProperties={};for(i
in a){g=f.camelCase(i),i!==g&&(a[g]=a[i],delete
a[i]),h=a[g],f.isArray(h)?(b.animatedProperties[g]=h[1],h=a[g]=h[0]):b.animatedProperties[g]=b.specialEasing&&b.specialEasing[g]|
|b.easing||"swing";if(h==="hide"&&d||h==="show"&&!d)return
b.complete.call(this);c&&(g==="height"||
g==="width")&&(b.overflow=[this.style.overflow,this.style.overflowX,this.style.overflowY],f.css(this,"display")==="inline"&&f.css(this,"float")==="none"&&(!f.support.inlineBlockNeedsLayout|
|
cv(this.nodeName)==="inline"?this.style.display="inline-block":this.style.zoom=1))}b.overflow!=null&&(this.style.overflow="hidden");for(i
in a)j=new f.fx(this,b,i),h=a[i],cn.test(h)?(o=f._data(this,"toggle"+i)||
(h==="toggle"?d?"show":"hide":0),o?(f._data(this,"toggle"+i,o==="show"?"hide":"show"),j[o]()):j[h]()):(k=co.exec(h),l=j.cur(),k?(m=parseFloat(k[2]),n=k[3]|
|(f.cssNumber[i]?"":"px"),n!=="px"&&(f.style(this,i,(m||1)+n),l=(m||
1)/j.cur()*l,f.style(this,i,l+n)),k[1]&&(m=(k[1]==="-="?-1:1)*m+l),j.custom(l,m,n)):j.custom(l,h,""));return!0}var
e=f.speed(b,c,d);if(f.isEmptyObject(a))return
this.each(e.complete,[!1]);a=f.extend({},a);return
e.queue===!1?this.each(g):this.queue(e.queue,g)},stop:function(a,c,d){typeof
a!="string"&&(d=c,c=a,a=b),c&&a!==!1&&this.queue(a||"fx",[]);return
this.each(function(){function h(a,b,c){var
e=b[c];f.removeData(a,c,!0),e.stop(d)}var
b,c=!1,e=f.timers,g=f._data(this);d||f._unmark(!0,this);if(a==null)for(b in
g)g[b]&&g[b].stop&&b.indexOf(".run")===b.length-4&&h(this,g,b);else
g[b=a+".run"]&&g[b].stop&&h(this,g,b);for(b=e.length;b--;)e[b].elem===this&&(a==null|
|e[b].queue===a)&&(d?e[b](!0):e[b].saveState(),c=!0,e.splice(b,1));(!d|
|!c)&&f.dequeue(this,a)})}}),f.each({slideDown:cu("show",1),slideUp:cu("hide",1),slideToggle:cu("toggle",1),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(a,b){f.fn[a]=function(a,c,d){return
this.animate(b,a,c,d)}}),f.extend({speed:function(a,b,c){var d=a&&typeof
a=="object"?f.extend({},a):{complete:c||!c&&b||
f.isFunction(a)&&a,duration:a,easing:c&&b||
b&&!f.isFunction(b)&&b};d.duration=f.fx.off?0:typeof
d.duration=="number"?d.duration:d.duration in
f.fx.speeds?f.fx.speeds[d.duration]:f.fx.speeds._default;if(d.queue==null||
d.queue===!0)d.queue="fx";d.old=d.complete,d.complete=function(a){f.isFunction(d.old)&&d.old.call(this),d.queue?f.dequeue(this,d.queue):a!==!1&&f._unmark(this)};return
d},easing:{linear:function(a,b,c,d){return
c+d*a},swing:function(a,b,c,d){return(-Math.cos(a*Math.PI)/2+.5)*d+c}},timers:[],fx:function(a,b,c){this.options=b,this.elem=a,this.prop=c,b.orig=b.orig|
|
{}}}),f.fx.prototype={update:function(){this.options.step&&this.options.step.call(this.elem,this.now,this),(f.fx.step[this.prop]|
|
f.fx.step._default)(this)},cur:function(){if(this.elem[this.prop]!=null&&(!this.elem.style|
|this.elem.style[this.prop]==null))return this.elem[this.prop];var
a,b=f.css(this.elem,this.prop);return isNaN(a=parseFloat(b))?!b||
b==="auto"?0:b:a},custom:function(a,c,d){function h(a){return e.step(a)}var
e=this,g=f.fx;this.startTime=cr||
cs(),this.end=c,this.now=this.start=a,this.pos=this.state=0,this.unit=d||
this.unit||
(f.cssNumber[this.prop]?"":"px"),h.queue=this.options.queue,h.elem=this.elem,h.saveState=function(){e.options.hide&&f._data(e.elem,"fxshow"+e.prop)===b&&f._data(e.elem,"fxshow"+e.prop,e.start)},h()&&f.timers.push(h)&&!cp&&(cp=setInterval(g.tick,g.interval))},show:function(){var
a=f._data(this.elem,"fxshow"+this.prop);this.options.orig[this.prop]=a||
f.style(this.elem,this.prop),this.options.show=!0,a!==b?this.custom(this.cur(),a):this.custom(this.prop==="width"|
|
this.prop==="height"?1:0,this.cur()),f(this.elem).show()},hide:function(){this.options.orig[this.prop]=f._data(this.elem,"fxshow"+this.prop)|
|
f.style(this.elem,this.prop),this.options.hide=!0,this.custom(this.cur(),0)},step:function(a){var
b,c,d,e=cr||cs(),g=!0,h=this.elem,i=this.options;if(a||
e>=i.duration+this.startTime){this.now=this.end,this.pos=this.state=1,this.update(),i.animatedProperties[this.prop]=!0;for(b
in
i.animatedProperties)i.animatedProperties[b]!==!0&&(g=!1);if(g){i.overflow!=null&&!f.support.shrinkWrapBlocks&&f.each(["","X","Y"],function(a,b){h.style["overflow"+b]=i.overflow[a]}),i.hide&&f(h).hide();if(i.hide|
|i.show)for(b in
i.animatedProperties)f.style(h,b,i.orig[b]),f.removeData(h,"fxshow"+b,!0),f.removeData(h,"toggle"+b,!0);d=i.complete,d&&(i.complete=!1,d.call(h))}return!1}i.duration==Infinity?this.now=e:(c=e-this.startTime,this.state=c/i.duration,this.pos=f.easing[i.animatedProperties[this.prop]](this.state,c,0,1,i.duration),this.now=this.start+(this.end-this.start)*this.pos),this.update();return!0}},f.extend(f.fx,{tick:function(){var
a,b=f.timers,c=0;for(;c<b.length;c++)a=b[c],!a()&&b[c]===a&&b.splice(c--,1);b.length|
|
f.fx.stop()},interval:13,stop:function(){clearInterval(cp),cp=null},speeds:{slow:600,fast:200,_default:400},step:{opacity:function(a){f.style(a.elem,"opacity",a.now)},_default:function(a){a.elem.style&&a.elem.style[a.prop]!=null?a.elem.style[a.prop]=a.now+a.unit:a.elem[a.prop]=a.now}}}),f.each(["width","height"],function(a,b){f.fx.step[b]=function(a){f.style(a.elem,b,Math.max(0,a.now)+a.unit)}}),f.expr&&f.expr.filters&&(f.expr.filters.animated=function(a){return
f.grep(f.timers,function(b){return a===b.elem}).length});var cw=/^t(?:able|
d|h)$/i,cx=/^(?:body|html)$/i;"getBoundingClientRect"in
c.documentElement?f.fn.offset=function(a){var b=this[0],c;if(a)return
this.each(function(b){f.offset.setOffset(this,a,b)});if(!b|
|!b.ownerDocument)return null;if(b===b.ownerDocument.body)return
f.offset.bodyOffset(b);try{c=b.getBoundingClientRect()}catch(d){}var
e=b.ownerDocument,g=e.documentElement;if(!c||!f.contains(g,b))return
c?{top:c.top,left:c.left}:{top:0,left:0};var h=e.body,i=cy(e),j=g.clientTop|
|h.clientTop||0,k=g.clientLeft||h.clientLeft||0,l=i.pageYOffset||
f.support.boxModel&&g.scrollTop||h.scrollTop,m=i.pageXOffset||
f.support.boxModel&&g.scrollLeft||
h.scrollLeft,n=c.top+l-j,o=c.left+m-k;return{top:n,left:o}}:f.fn.offset=function(a){var
b=this[0];if(a)return
this.each(function(b){f.offset.setOffset(this,a,b)});if(!b|
|!b.ownerDocument)return null;if(b===b.ownerDocument.body)return
f.offset.bodyOffset(b);var
c,d=b.offsetParent,e=b,g=b.ownerDocument,h=g.documentElement,i=g.body,j=g.defaultView,k=j?j.getComputedStyle(b,null):b.currentStyle,l=b.offsetTop,m=b.offsetLeft;while((b=b.parentNode)&&b!==i&&b!==h){if(f.support.fixedPosition&&k.position==="fixed")break;c=j?j.getComputedStyle(b,null):b.currentStyle,l-=b.scrollTop,m-=b.scrollLeft,b===d&&(l+=b.offsetTop,m+=b.offsetLeft,f.support.doesNotAddBorder&&(!f.support.doesAddBorderForTableAndCells|
|!cw.test(b.nodeName))&&(l+=parseFloat(c.borderTopWidth)||
0,m+=parseFloat(c.borderLeftWidth)||
0),e=d,d=b.offsetParent),f.support.subtractsBorderForOverflowNotVisible&&c.overflow!=="visible"&&(l+=parseFloat(c.borderTopWidth)|
|0,m+=parseFloat(c.borderLeftWidth)||0),k=c}if(k.position==="relative"||
k.position==="static")l+=i.offsetTop,m+=i.offsetLeft;f.support.fixedPosition&&k.position==="fixed"&&(l+=Math.max(h.scrollTop,i.scrollTop),m+=Math.max(h.scrollLeft,i.scrollLeft));return{top:l,left:m}},f.offset={bodyOffset:function(a){var
b=a.offsetTop,c=a.offsetLeft;f.support.doesNotIncludeMarginInBodyOffset&&(b+=parseFloat(f.css(a,"marginTop"))|
|0,c+=parseFloat(f.css(a,"marginLeft"))||
0);return{top:b,left:c}},setOffset:function(a,b,c){var
d=f.css(a,"position");d==="static"&&(a.style.position="relative");var
e=f(a),g=e.offset(),h=f.css(a,"top"),i=f.css(a,"left"),j=(d==="absolute"||
d==="fixed")&&f.inArray("auto",[h,i])>-1,k={},l={},m,n;j?(l=e.position(),m=l.top,n=l.left):(m=parseFloat(h)|
|0,n=parseFloat(i)||
0),f.isFunction(b)&&(b=b.call(a,c,g)),b.top!=null&&(k.top=b.top-g.top+m),b.left!=null&&(k.left=b.left-g.left+n),"using"in
b?b.using.call(a,k):e.css(k)}},f.fn.extend({position:function(){if(!this[0])return
null;var
a=this[0],b=this.offsetParent(),c=this.offset(),d=cx.test(b[0].nodeName)?{top:0,left:0}:b.offset();c.top-=parseFloat(f.css(a,"marginTop"))|
|0,c.left-=parseFloat(f.css(a,"marginLeft"))||
0,d.top+=parseFloat(f.css(b[0],"borderTopWidth"))||
0,d.left+=parseFloat(f.css(b[0],"borderLeftWidth"))||
0;return{top:c.top-d.top,left:c.left-d.left}},offsetParent:function(){return
this.map(function(){var a=this.offsetParent||
c.body;while(a&&!cx.test(a.nodeName)&&f.css(a,"position")==="static")a=a.offsetParent;return
a})}}),f.each(["Left","Top"],function(a,c){var
d="scroll"+c;f.fn[d]=function(c){var e,g;if(c===b){e=this[0];if(!e)return
null;g=cy(e);return g?"pageXOffset"in
g?g[a?"pageYOffset":"pageXOffset"]:f.support.boxModel&&g.document.documentElement[d]|
|g.document.body[d]:e[d]}return
this.each(function(){g=cy(this),g?g.scrollTo(a?f(g).scrollLeft():c,a?c:f(g).scrollTop()):this[d]=c})}}),f.each(["Height","Width"],function(a,c){var
d=c.toLowerCase();f.fn["inner"+c]=function(){var a=this[0];return
a?a.style?parseFloat(f.css(a,d,"padding")):this[d]():null},f.fn["outer"+c]=function(a){var
b=this[0];return
b?b.style?parseFloat(f.css(b,d,a?"margin":"border")):this[d]():null},f.fn[d]=function(a){var
e=this[0];if(!e)return a==null?null:this;if(f.isFunction(a))return
this.each(function(b){var
c=f(this);c[d](a.call(this,b,c[d]()))});if(f.isWindow(e)){var
g=e.document.documentElement["client"+c],h=e.document.body;return
e.document.compatMode==="CSS1Compat"&&g||h&&h["client"+c]||
g}if(e.nodeType===9)return
Math.max(e.documentElement["client"+c],e.body["scroll"+c],e.documentElement["scroll"+c],e.body["offset"+c],e.documentElement["offset"+c]);if(a===b){var
i=f.css(e,d),j=parseFloat(i);return f.isNumeric(j)?j:i}return
this.css(d,typeof a=="string"?a:a+"px")}}),a.jQuery=a.$=f,typeof
define=="function"&&define.amd&&define.amd.jQuery&&define("jquery",[],function(){return
f})})(window);
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/_static/minus.png
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,14 @@
+ PNG
+
+
+IHDR
+
+ &Îàq pHYs
+
+ tIME ×
+ <(R)8å tEXtComment öÌ ¿ RIDAT Óc<sæ
+ ^ÀÂÀÀ ¢¢ Uîß¿ ÷îÝc E ab <<` P rG
+E¨8~ü8Ü
+LLLÈn¢ ;Ð| Æea``¸wï
+
+3 Ð= U³[ . IEND(R)B`
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/_static/plus.png Mon
Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,13 @@
+ PNG
+
+
+IHDR
+
+ &Îàq pHYs
+
+ tIME ×
+1 l9 tEXtComment öÌ ¿ RIDAT Óc<sæ
+ ^ÀÂÀÀ ¢¢ Uîß¿ ÷îÝcB µ´´D ab <<`Á4
+Î>zô(BÅñãÇáÒpö¿ ÿ¨è ip>> ¹P ÷îÝÃc
+· ¸
+|¶ IEND(R)B`
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/_static/pygments.css
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,62 @@
+.highlight .hll { background-color: #ffffcc }
+.highlight { background: #eeffcc; }
+.highlight .c { color: #408090; font-style: italic } /* Comment */
+.highlight .err { border: 1px solid #FF0000 } /* Error */
+.highlight .k { color: #007020; font-weight: bold } /* Keyword */
+.highlight .o { color: #666666 } /* Operator */
+.highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline
*/
+.highlight .cp { color: #007020 } /* Comment.Preproc */
+.highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */
+.highlight .cs { color: #408090; background-color: #fff0f0 } /*
Comment.Special */
+.highlight .gd { color: #A00000 } /* Generic.Deleted */
+.highlight .ge { font-style: italic } /* Generic.Emph */
+.highlight .gr { color: #FF0000 } /* Generic.Error */
+.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
+.highlight .gi { color: #00A000 } /* Generic.Inserted */
+.highlight .go { color: #333333 } /* Generic.Output */
+.highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */
+.highlight .gs { font-weight: bold } /* Generic.Strong */
+.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading
*/
+.highlight .gt { color: #0044DD } /* Generic.Traceback */
+.highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */
+.highlight .kd { color: #007020; font-weight: bold } /*
Keyword.Declaration */
+.highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace
*/
+.highlight .kp { color: #007020 } /* Keyword.Pseudo */
+.highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */
+.highlight .kt { color: #902000 } /* Keyword.Type */
+.highlight .m { color: #208050 } /* Literal.Number */
+.highlight .s { color: #4070a0 } /* Literal.String */
+.highlight .na { color: #4070a0 } /* Name.Attribute */
+.highlight .nb { color: #007020 } /* Name.Builtin */
+.highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */
+.highlight .no { color: #60add5 } /* Name.Constant */
+.highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */
+.highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */
+.highlight .ne { color: #007020 } /* Name.Exception */
+.highlight .nf { color: #06287e } /* Name.Function */
+.highlight .nl { color: #002070; font-weight: bold } /* Name.Label */
+.highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */
+.highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */
+.highlight .nv { color: #bb60d5 } /* Name.Variable */
+.highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */
+.highlight .w { color: #bbbbbb } /* Text.Whitespace */
+.highlight .mf { color: #208050 } /* Literal.Number.Float */
+.highlight .mh { color: #208050 } /* Literal.Number.Hex */
+.highlight .mi { color: #208050 } /* Literal.Number.Integer */
+.highlight .mo { color: #208050 } /* Literal.Number.Oct */
+.highlight .sb { color: #4070a0 } /* Literal.String.Backtick */
+.highlight .sc { color: #4070a0 } /* Literal.String.Char */
+.highlight .sd { color: #4070a0; font-style: italic } /*
Literal.String.Doc */
+.highlight .s2 { color: #4070a0 } /* Literal.String.Double */
+.highlight .se { color: #4070a0; font-weight: bold } /*
Literal.String.Escape */
+.highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */
+.highlight .si { color: #70a0d0; font-style: italic } /*
Literal.String.Interpol */
+.highlight .sx { color: #c65d09 } /* Literal.String.Other */
+.highlight .sr { color: #235388 } /* Literal.String.Regex */
+.highlight .s1 { color: #4070a0 } /* Literal.String.Single */
+.highlight .ss { color: #517918 } /* Literal.String.Symbol */
+.highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */
+.highlight .vc { color: #bb60d5 } /* Name.Variable.Class */
+.highlight .vg { color: #bb60d5 } /* Name.Variable.Global */
+.highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */
+.highlight .il { color: #208050 } /* Literal.Number.Integer.Long */
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_static/searchtools.js
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,622 @@
+/*
+ * searchtools.js_t
+ * ~~~~~~~~~~~~~~~~
+ *
+ * Sphinx JavaScript utilties for the full-text search.
+ *
+ * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+
+/**
+ * Porter Stemmer
+ */
+var Stemmer = function() {
+
+ var step2list = {
+ ational: 'ate',
+ tional: 'tion',
+ enci: 'ence',
+ anci: 'ance',
+ izer: 'ize',
+ bli: 'ble',
+ alli: 'al',
+ entli: 'ent',
+ eli: 'e',
+ ousli: 'ous',
+ ization: 'ize',
+ ation: 'ate',
+ ator: 'ate',
+ alism: 'al',
+ iveness: 'ive',
+ fulness: 'ful',
+ ousness: 'ous',
+ aliti: 'al',
+ iviti: 'ive',
+ biliti: 'ble',
+ logi: 'log'
+ };
+
+ var step3list = {
+ icate: 'ic',
+ ative: '',
+ alize: 'al',
+ iciti: 'ic',
+ ical: 'ic',
+ ful: '',
+ ness: ''
+ };
+
+ var c = "[^aeiou]"; // consonant
+ var v = "[aeiouy]"; // vowel
+ var C = c + "[^aeiouy]*"; // consonant sequence
+ var V = v + "[aeiou]*"; // vowel sequence
+
+ var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is
m>0
+ var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is
m=1
+ var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC...
is m>1
+ var s_v = "^(" + C + ")?" + v; // vowel in stem
+
+ this.stemWord = function (w) {
+ var stem;
+ var suffix;
+ var firstch;
+ var origword = w;
+
+ if (w.length < 3)
+ return w;
+
+ var re;
+ var re2;
+ var re3;
+ var re4;
+
+ firstch = w.substr(0,1);
+ if (firstch == "y")
+ w = firstch.toUpperCase() + w.substr(1);
+
+ // Step 1a
+ re = /^(.+?)(ss|i)es$/;
+ re2 = /^(.+?)([^s])s$/;
+
+ if (re.test(w))
+ w = w.replace(re,"$1$2");
+ else if (re2.test(w))
+ w = w.replace(re2,"$1$2");
+
+ // Step 1b
+ re = /^(.+?)eed$/;
+ re2 = /^(.+?)(ed|ing)$/;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ re = new RegExp(mgr0);
+ if (re.test(fp[1])) {
+ re = /.$/;
+ w = w.replace(re,"");
+ }
+ }
+ else if (re2.test(w)) {
+ var fp = re2.exec(w);
+ stem = fp[1];
+ re2 = new RegExp(s_v);
+ if (re2.test(stem)) {
+ w = stem;
+ re2 = /(at|bl|iz)$/;
+ re3 = new RegExp("([^aeiouylsz])\\1$");
+ re4 = new RegExp("^" + C + v + "[^aeiouwxy]$");
+ if (re2.test(w))
+ w = w + "e";
+ else if (re3.test(w)) {
+ re = /.$/;
+ w = w.replace(re,"");
+ }
+ else if (re4.test(w))
+ w = w + "e";
+ }
+ }
+
+ // Step 1c
+ re = /^(.+?)y$/;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ re = new RegExp(s_v);
+ if (re.test(stem))
+ w = stem + "i";
+ }
+
+ // Step 2
+ re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|
ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ suffix = fp[2];
+ re = new RegExp(mgr0);
+ if (re.test(stem))
+ w = stem + step2list[suffix];
+ }
+
+ // Step 3
+ re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ suffix = fp[2];
+ re = new RegExp(mgr0);
+ if (re.test(stem))
+ w = stem + step3list[suffix];
+ }
+
+ // Step 4
+ re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|
ate|iti|ous|ive|ize)$/;
+ re2 = /^(.+?)(s|t)(ion)$/;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ re = new RegExp(mgr1);
+ if (re.test(stem))
+ w = stem;
+ }
+ else if (re2.test(w)) {
+ var fp = re2.exec(w);
+ stem = fp[1] + fp[2];
+ re2 = new RegExp(mgr1);
+ if (re2.test(stem))
+ w = stem;
+ }
+
+ // Step 5
+ re = /^(.+?)e$/;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ re = new RegExp(mgr1);
+ re2 = new RegExp(meq1);
+ re3 = new RegExp("^" + C + v + "[^aeiouwxy]$");
+ if (re.test(stem) || (re2.test(stem) && !(re3.test(stem))))
+ w = stem;
+ }
+ re = /ll$/;
+ re2 = new RegExp(mgr1);
+ if (re.test(w) && re2.test(w)) {
+ re = /.$/;
+ w = w.replace(re,"");
+ }
+
+ // and turn initial Y back to y
+ if (firstch == "y")
+ w = firstch.toLowerCase() + w.substr(1);
+ return w;
+ }
+}
+
+
+
+/**
+ * Simple result scoring code.
+ */
+var Scorer = {
+ // Implement the following function to further tweak the score for each
result
+ // The function takes a result array [filename, title, anchor, descr,
score]
+ // and returns the new score.
+ /*
+ score: function(result) {
+ return result[4];
+ },
+ */
+
+ // query matches the full name of an object
+ objNameMatch: 11,
+ // or matches in the last dotted part of the object name
+ objPartialMatch: 6,
+ // Additive scores depending on the priority of the object
+ objPrio: {0: 15, // used to be importantResults
+ 1: 5, // used to be objectResults
+ 2: -5}, // used to be unimportantResults
+ // Used when the priority is not in the mapping.
+ objPrioDefault: 0,
+
+ // query found in title
+ title: 15,
+ // query found in terms
+ term: 5
+};
+
+
+/**
+ * Search Module
+ */
+var Search = {
+
+ _index : null,
+ _queued_query : null,
+ _pulse_status : -1,
+
+ init : function() {
+ var params = $.getQueryParameters();
+ if (params.q) {
+ var query = params.q[0];
+ $('input[name="q"]')[0].value = query;
+ this.performSearch(query);
+ }
+ },
+
+ loadIndex : function(url) {
+ $.ajax({type: "GET", url: url, data: null,
+ dataType: "script", cache: true,
+ complete: function(jqxhr, textstatus) {
+ if (textstatus != "success") {
+ document.getElementById("searchindexloader").src = url;
+ }
+ }});
+ },
+
+ setIndex : function(index) {
+ var q;
+ this._index = index;
+ if ((q = this._queued_query) !== null) {
+ this._queued_query = null;
+ Search.query(q);
+ }
+ },
+
+ hasIndex : function() {
+ return this._index !== null;
+ },
+
+ deferQuery : function(query) {
+ this._queued_query = query;
+ },
+
+ stopPulse : function() {
+ this._pulse_status = 0;
+ },
+
+ startPulse : function() {
+ if (this._pulse_status >= 0)
+ return;
+ function pulse() {
+ var i;
+ Search._pulse_status = (Search._pulse_status + 1) % 4;
+ var dotString = '';
+ for (i = 0; i < Search._pulse_status; i++)
+ dotString += '.';
+ Search.dots.text(dotString);
+ if (Search._pulse_status > -1)
+ window.setTimeout(pulse, 500);
+ }
+ pulse();
+ },
+
+ /**
+ * perform a search for something (or wait until index is loaded)
+ */
+ performSearch : function(query) {
+ // create the required interface elements
+ this.out = $('#search-results');
+ this.title = $('<h2>' + _('Searching') + '</h2>').appendTo(this.out);
+ this.dots = $('<span></span>').appendTo(this.title);
+ this.status = $('<p style="display: none"></p>').appendTo(this.out);
+ this.output = $('<ul class="search"/>').appendTo(this.out);
+
+ $('#search-progress').text(_('Preparing search...'));
+ this.startPulse();
+
+ // index already loaded, the browser was quick!
+ if (this.hasIndex())
+ this.query(query);
+ else
+ this.deferQuery(query);
+ },
+
+ /**
+ * execute search (requires search index to be loaded)
+ */
+ query : function(query) {
+ var i;
+ var stopwords =
["a","and","are","as","at","be","but","by","for","if","in","into","is","it","near","no","not","of","on","or","such","that","the","their","then","there","these","they","this","to","was","will","with"];
+
+ // stem the searchterms and add them to the correct list
+ var stemmer = new Stemmer();
+ var searchterms = [];
+ var excluded = [];
+ var hlterms = [];
+ var tmp = query.split(/\s+/);
+ var objectterms = [];
+ for (i = 0; i < tmp.length; i++) {
+ if (tmp[i] !== "") {
+ objectterms.push(tmp[i].toLowerCase());
+ }
+
+ if ($u.indexOf(stopwords, tmp[i]) != -1 || tmp[i].match(/^\d+$/) ||
+ tmp[i] === "") {
+ // skip this "word"
+ continue;
+ }
+ // stem the word
+ var word = stemmer.stemWord(tmp[i]).toLowerCase();
+ var toAppend;
+ // select the correct list
+ if (word[0] == '-') {
+ toAppend = excluded;
+ word = word.substr(1);
+ }
+ else {
+ toAppend = searchterms;
+ hlterms.push(tmp[i].toLowerCase());
+ }
+ // only add if not already in the list
+ if (!$u.contains(toAppend, word))
+ toAppend.push(word);
+ }
+ var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" "));
+
+ // console.debug('SEARCH: searching for:');
+ //
console.info('required: ', searchterms);
+ //
console.info('excluded: ', excluded);
+
+ // prepare search
+ var terms = this._index.terms;
+ var titleterms = this._index.titleterms;
+
+ // array of [filename, title, anchor, descr, score]
+ var results = [];
+ $('#search-progress').empty();
+
+ // lookup as object
+ for (i = 0; i < objectterms.length; i++) {
+ var others = [].concat(objectterms.slice(0, i),
+ objectterms.slice(i+1, objectterms.length));
+ results = results.concat(this.performObjectSearch(objectterms[i],
others));
+ }
+
+ // lookup as search terms in fulltext
+ results = results.concat(this.performTermsSearch(searchterms,
excluded, terms, Scorer.term))
+ .concat(this.performTermsSearch(searchterms,
excluded, titleterms, Scorer.title));
+
+ // let the scorer override scores with a custom scoring function
+ if (Scorer.score) {
+ for (i = 0; i < results.length; i++)
+ results[i][4] = Scorer.score(results[i]);
+ }
+
+ // now sort the results by score (in opposite order of appearance,
since the
+ // display function below uses pop() to retrieve items) and then
+ // alphabetically
+ results.sort(function(a, b) {
+ var left = a[4];
+ var right = b[4];
+ if (left > right) {
+ return 1;
+ } else if (left < right) {
+ return -1;
+ } else {
+ // same score: sort alphabetically
+ left = a[1].toLowerCase();
+ right = b[1].toLowerCase();
+ return (left > right) ? -1 : ((left < right) ? 1 : 0);
+ }
+ });
+
+ // for debugging
+ //Search.lastresults = results.slice(); // a copy
+ //
console.info('search results:', Search.lastresults);
+
+ // print the results
+ var resultCount = results.length;
+ function displayNextItem() {
+ // results left, load the summary and display it
+ if (results.length) {
+ var item = results.pop();
+ var listItem = $('<li style="display:none"></li>');
+ if (DOCUMENTATION_OPTIONS.FILE_SUFFIX === '') {
+ // dirhtml builder
+ var dirname = item[0] + '/';
+ if (dirname.match(/\/index\/$/)) {
+ dirname = dirname.substring(0, dirname.length-6);
+ } else if (dirname == 'index/') {
+ dirname = '';
+ }
+ listItem.append($('<a/>').attr('href',
+ DOCUMENTATION_OPTIONS.URL_ROOT + dirname +
+ highlightstring + item[2]).html(item[1]));
+ } else {
+ // normal html builders
+ listItem.append($('<a/>').attr('href',
+ item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX +
+ highlightstring + item[2]).html(item[1]));
+ }
+ if (item[3]) {
+ listItem.append($('<span> (' + item[3] + ')</span>'));
+ Search.output.append(listItem);
+ listItem.slideDown(5, function() {
+ displayNextItem();
+ });
+ } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) {
+ $.ajax({url: DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/' +
item[0] + '.txt',
+ dataType: "text",
+ complete: function(jqxhr, textstatus) {
+ var data = jqxhr.responseText;
+ if (data !== '') {
+ listItem.append(Search.makeSearchSummary(data,
searchterms, hlterms));
+ }
+ Search.output.append(listItem);
+ listItem.slideDown(5, function() {
+ displayNextItem();
+ });
+ }});
+ } else {
+ // no source available, just display title
+ Search.output.append(listItem);
+ listItem.slideDown(5, function() {
+ displayNextItem();
+ });
+ }
+ }
+ // search finished, update title and status message
+ else {
+ Search.stopPulse();
+ Search.title.text(_('Search Results'));
+ if (!resultCount)
+ Search.status.text(_('Your search did not match any documents.
Please make sure that all words are spelled correctly and that you\'ve
selected enough categories.'));
+ else
+ Search.status.text(_('Search finished, found %s page(s)
matching the search query.').replace('%s', resultCount));
+ Search.status.fadeIn(500);
+ }
+ }
+ displayNextItem();
+ },
+
+ /**
+ * search for object names
+ */
+ performObjectSearch : function(object, otherterms) {
+ var filenames = this._index.filenames;
+ var objects = this._index.objects;
+ var objnames = this._index.objnames;
+ var titles = this._index.titles;
+
+ var i;
+ var results = [];
+
+ for (var prefix in objects) {
+ for (var name in objects[prefix]) {
+ var fullname = (prefix ? prefix + '.' : '') + name;
+ if (fullname.toLowerCase().indexOf(object) > -1) {
+ var score = 0;
+ var parts = fullname.split('.');
+ // check for different match types: exact matches of full name or
+ // "last name" (i.e. last dotted part)
+ if (fullname == object || parts[parts.length - 1] == object) {
+ score += Scorer.objNameMatch;
+ // matches in last name
+ } else if (parts[parts.length - 1].indexOf(object) > -1) {
+ score += Scorer.objPartialMatch;
+ }
+ var match = objects[prefix][name];
+ var objname = objnames[match[1]][2];
+ var title = titles[match[0]];
+ // If more than one term searched for, we require other words to
be
+ // found in the name/title/description
+ if (otherterms.length > 0) {
+ var haystack = (prefix + ' ' + name + ' ' +
+ objname + ' ' + title).toLowerCase();
+ var allfound = true;
+ for (i = 0; i < otherterms.length; i++) {
+ if (haystack.indexOf(otherterms[i]) == -1) {
+ allfound = false;
+ break;
+ }
+ }
+ if (!allfound) {
+ continue;
+ }
+ }
+ var descr = objname + _(', in ') + title;
+
+ var anchor = match[3];
+ if (anchor === '')
+ anchor = fullname;
+ else if (anchor == '-')
+ anchor = objnames[match[1]][1] + '-' + fullname;
+ // add custom score for some objects according to scorer
+ if (Scorer.objPrio.hasOwnProperty(match[2])) {
+ score += Scorer.objPrio[match[2]];
+ } else {
+ score += Scorer.objPrioDefault;
+ }
+ results.push([filenames[match[0]], fullname, '#'+anchor, descr,
score]);
+ }
+ }
+ }
+
+ return results;
+ },
+
+ /**
+ * search for full-text terms in the index
+ */
+ performTermsSearch : function(searchterms, excluded, terms, score) {
+ var filenames = this._index.filenames;
+ var titles = this._index.titles;
+
+ var i, j, file, files;
+ var fileMap = {};
+ var results = [];
+
+ // perform the search on the required terms
+ for (i = 0; i < searchterms.length; i++) {
+ var word = searchterms[i];
+ // no match but word was a required one
+ if (!(files = terms[word]))
+ break;
+ if (files.length === undefined) {
+ files = [files];
+ }
+ // create the mapping
+ for (j = 0; j < files.length; j++) {
+ file = files[j];
+ if (file in fileMap)
+ fileMap[file].push(word);
+ else
+ fileMap[file] = [word];
+ }
+ }
+
+ // now check if the files don't contain excluded terms
+ for (file in fileMap) {
+ var valid = true;
+
+ // check if all requirements are matched
+ if (fileMap[file].length != searchterms.length)
+ continue;
+
+ // ensure that none of the excluded terms is in the search result
+ for (i = 0; i < excluded.length; i++) {
+ if (terms[excluded[i]] == file ||
+ $u.contains(terms[excluded[i]] || [], file)) {
+ valid = false;
+ break;
+ }
+ }
+
+ // if we have still a valid result we can add it to the result list
+ if (valid) {
+ results.push([filenames[file], titles[file], '', null, score]);
+ }
+ }
+ return results;
+ },
+
+ /**
+ * helper function to return a node containing the
+ * search summary for a given text. keywords is a list
+ * of stemmed words, hlwords is the list of normal, unstemmed
+ * words. the first one is used to find the occurance, the
+ * latter for highlighting it.
+ */
+ makeSearchSummary : function(text, keywords, hlwords) {
+ var textLower = text.toLowerCase();
+ var start = 0;
+ $.each(keywords, function() {
+ var i = textLower.indexOf(this.toLowerCase());
+ if (i > -1)
+ start = i;
+ });
+ start = Math.max(start - 120, 0);
+ var excerpt = ((start > 0) ? '...' : '') +
+ $.trim(text.substr(start, 240)) +
+ ((start + 240 - text.length) ? '...' : '');
+ var rv = $('<div class="context"></div>').text(excerpt);
+ $.each(hlwords, function() {
+ rv = rv.highlightText(this, 'highlighted');
+ });
+ return rv;
+ }
+};
+
+$(document).ready(function() {
+ Search.init();
+});
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/_static/sidebar.js
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,159 @@
+/*
+ * sidebar.js
+ * ~~~~~~~~~~
+ *
+ * This script makes the Sphinx sidebar collapsible.
+ *
+ * .sphinxsidebar contains .sphinxsidebarwrapper. This script adds
+ * in .sphixsidebar, after .sphinxsidebarwrapper, the #sidebarbutton
+ * used to collapse and expand the sidebar.
+ *
+ * When the sidebar is collapsed the .sphinxsidebarwrapper is hidden
+ * and the width of the sidebar and the margin-left of the document
+ * are decreased. When the sidebar is expanded the opposite happens.
+ * This script saves a per-browser/per-session cookie used to
+ * remember the position of the sidebar among the pages.
+ * Once the browser is closed the cookie is deleted and the position
+ * reset to the default (expanded).
+ *
+ * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+$(function() {
+
+
+
+
+
+
+
+
+ // global elements used by the functions.
+ // the 'sidebarbutton' element is defined as global after its
+ // creation, in the add_sidebar_button function
+ var bodywrapper = $('.bodywrapper');
+ var sidebar = $('.sphinxsidebar');
+ var sidebarwrapper = $('.sphinxsidebarwrapper');
+
+ // for some reason, the document has no sidebar; do not run into errors
+ if (!sidebar.length) return;
+
+ // original margin-left of the bodywrapper and width of the sidebar
+ // with the sidebar expanded
+ var bw_margin_expanded = bodywrapper.css('margin-left');
+ var ssb_width_expanded = sidebar.width();
+
+ // margin-left of the bodywrapper and width of the sidebar
+ // with the sidebar collapsed
+ var bw_margin_collapsed = '.8em';
+ var ssb_width_collapsed = '.8em';
+
+ // colors used by the current theme
+ var dark_color = $('.related').css('background-color');
+ var light_color = $('.document').css('background-color');
+
+ function sidebar_is_collapsed() {
+ return
sidebarwrapper.is(':not(:visible)');
+ }
+
+ function toggle_sidebar() {
+ if (sidebar_is_collapsed())
+ expand_sidebar();
+ else
+ collapse_sidebar();
+ }
+
+ function collapse_sidebar() {
+ sidebarwrapper.hide();
+ sidebar.css('width', ssb_width_collapsed);
+ bodywrapper.css('margin-left', bw_margin_collapsed);
+ sidebarbutton.css({
+ 'margin-left': '0',
+ 'height': bodywrapper.height()
+ });
+ sidebarbutton.find('span').text('>>');
+ sidebarbutton.attr('title', _('Expand sidebar'));
+ document.cookie = 'sidebar=collapsed';
+ }
+
+ function expand_sidebar() {
+ bodywrapper.css('margin-left', bw_margin_expanded);
+ sidebar.css('width', ssb_width_expanded);
+ sidebarwrapper.show();
+ sidebarbutton.css({
+ 'margin-left': ssb_width_expanded-12,
+ 'height': bodywrapper.height()
+ });
+ sidebarbutton.find('span').text('<<');
+ sidebarbutton.attr('title', _('Collapse sidebar'));
+ document.cookie = 'sidebar=expanded';
+ }
+
+ function add_sidebar_button() {
+ sidebarwrapper.css({
+ 'float': 'left',
+ 'margin-right': '0',
+ 'width': ssb_width_expanded - 28
+ });
+ // create the button
+ sidebar.append(
+ '<div id="sidebarbutton"><span>«</span></div>'
+ );
+ var sidebarbutton = $('#sidebarbutton');
+ light_color = sidebarbutton.css('background-color');
+ // find the height of the viewport to center the '<<' in the page
+ var viewport_height;
+ if (window.innerHeight)
+ viewport_height = window.innerHeight;
+ else
+ viewport_height = $(window).height();
+ sidebarbutton.find('span').css({
+ 'display': 'block',
+ 'margin-top': (viewport_height - sidebar.position().top - 20) / 2
+ });
+
+ sidebarbutton.click(toggle_sidebar);
+ sidebarbutton.attr('title', _('Collapse sidebar'));
+ sidebarbutton.css({
+ 'color': '#FFFFFF',
+ 'border-left': '1px solid ' + dark_color,
+ 'font-size': '1.2em',
+ 'cursor': 'pointer',
+ 'height': bodywrapper.height(),
+ 'padding-top': '1px',
+ 'margin-left': ssb_width_expanded - 12
+ });
+
+ sidebarbutton.hover(
+ function () {
+ $(this).css('background-color', dark_color);
+ },
+ function () {
+ $(this).css('background-color', light_color);
+ }
+ );
+ }
+
+ function set_position_from_cookie() {
+ if (!document.cookie)
+ return;
+ var items = document.cookie.split(';');
+ for(var k=0; k<items.length; k++) {
+ var key_val = items[k].split('=');
+ var key = key_val[0];
+ if (key == 'sidebar') {
+ var value = key_val[1];
+ if ((value == 'collapsed') && (!sidebar_is_collapsed()))
+ collapse_sidebar();
+ else if ((value == 'expanded') && (sidebar_is_collapsed()))
+ expand_sidebar();
+ }
+ }
+ }
+
+ add_sidebar_button();
+ var sidebarbutton = $('#sidebarbutton');
+ set_position_from_cookie();
+});
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_static/underscore.js
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,31 @@
+// Underscore.js 1.3.1
+// (c) 2009-2012 Jeremy Ashkenas, DocumentCloud Inc.
+// Underscore is freely distributable under the MIT license.
+// Portions of Underscore are inspired or borrowed from Prototype,
+// Oliver Steele's Functional, and John Resig's Micro-Templating.
+// For all details and documentation:
+//
http://documentcloud.github.com/underscore
+(function(){function q(a,c,d){if(a===c)return a!==0||1/a==1/c;if(a==null||
c==null)return
a===c;if(a._chain)a=a._wrapped;if(c._chain)c=c._wrapped;if(a.isEqual&&b.isFunction(a.isEqual))return
a.isEqual(c);if(c.isEqual&&b.isFunction(c.isEqual))return c.isEqual(a);var
e=l.call(a);if(e!=l.call(c))return false;switch(e){case "[object
String]":return a==String(c);case "[object Number]":return
a!=+a?c!=+c:a==0?1/a==1/c:a==+c;case "[object Date]":case "[object
Boolean]":return+a==+c;case "[object RegExp]":return a.source==
+c.source&&a.global==c.global&&a.multiline==c.multiline&&a.ignoreCase==c.ignoreCase}if(typeof
a!="object"|
|typeof c!="object")return false;for(var
f=d.length;f--;)if(d[f]==a)return true;d.push(a);var
f=0,g=true;if(e=="[object
Array]"){if(f=a.length,g=f==c.length)for(;f--;)if(!(g=f in a==f in
c&&q(a[f],c[f],d)))break}else{if("constructor"in a!="constructor"in c||
a.constructor!=c.constructor)return false;for(var h in
a)if(b.has(a,h)&&(f++,!(g=b.has(c,h)&&q(a[h],c[h],d))))break;if(g){for(h in
c)if(b.has(c,
+h)&&!f--)break;g=!f}}d.pop();return g}var
r=this,G=r._,n={},k=Array.prototype,o=Object.prototype,i=k.slice,H=k.unshift,l=o.toString,I=o.hasOwnProperty,w=k.forEach,x=k.map,y=k.reduce,z=k.reduceRight,A=k.filter,B=k.every,C=k.some,p=k.indexOf,D=k.lastIndexOf,o=Array.isArray,J=Object.keys,s=Function.prototype.bind,b=function(a){return
new m(a)};if(typeof exports!=="undefined"){if(typeof
module!=="undefined"&&module.exports)exports=module.exports=b;exports._=b}else
r._=b;b.VERSION="1.3.1";var j=b.each=
+b.forEach=function(a,c,d){if(a!=null)if(w&&a.forEach===w)a.forEach(c,d);else
if(a.length===+a.length)for(var
e=0,f=a.length;e<f;e++){if(e in
a&&c.call(d,a[e],e,a)===n)break}else for(e in
a)if(b.has(a,e)&&c.call(d,a[e],e,a)===n)break};b.map=b.collect=function(a,c,b){var
e=[];if(a==null)return e;if(x&&a.map===x)return
a.map(c,b);j(a,function(a,g,h){e[e.length]=c.call(b,a,g,h)});if(a.length===+a.length)e.length=a.length;return
e};b.reduce=b.foldl=b.inject=function(a,c,d,e){var f=arguments.length>2;a==
+null&&(a=[]);if(y&&a.reduce===y)return
e&&(c=b.bind(c,e)),f?a.reduce(c,d):a.reduce(c);j(a,function(a,b,i){f?d=c.call(e,d,a,b,i):(d=a,f=true)});if(!f)throw
new TypeError("Reduce of empty array with no initial value");return
d};b.reduceRight=b.foldr=function(a,c,d,e){var
f=arguments.length>2;a==null&&(a=[]);if(z&&a.reduceRight===z)return
e&&(c=b.bind(c,e)),f?a.reduceRight(c,d):a.reduceRight(c);var
g=b.toArray(a).reverse();e&&!f&&(c=b.bind(c,e));return
f?b.reduce(g,c,d,e):b.reduce(g,c)};b.find=b.detect=
+function(a,c,b){var e;E(a,function(a,g,h){if(c.call(b,a,g,h))return
e=a,true});return e};b.filter=b.select=function(a,c,b){var
e=[];if(a==null)return e;if(A&&a.filter===A)return
a.filter(c,b);j(a,function(a,g,h){c.call(b,a,g,h)&&(e[e.length]=a)});return
e};b.reject=function(a,c,b){var e=[];if(a==null)return
e;j(a,function(a,g,h){c.call(b,a,g,h)||(e[e.length]=a)});return
e};b.every=b.all=function(a,c,b){var e=true;if(a==null)return
e;if(B&&a.every===B)return a.every(c,b);j(a,function(a,g,h){if(!(e=
+e&&c.call(b,a,g,h)))return n});return e};var
E=b.some=b.any=function(a,c,d){c||(c=b.identity);var
e=false;if(a==null)return e;if(C&&a.some===C)return
a.some(c,d);j(a,function(a,b,h){if(e||(e=c.call(d,a,b,h)))return
n});return!!e};b.include=b.contains=function(a,c){var
b=false;if(a==null)return b;return
p&&a.indexOf===p?a.indexOf(c)!=-1:b=E(a,function(a){return
a===c})};b.invoke=function(a,c){var d=i.call(arguments,2);return
b.map(a,function(a){return(b.isFunction(c)?c||a:a[c]).apply(a,d)})};b.pluck=
+function(a,c){return b.map(a,function(a){return
a[c]})};b.max=function(a,c,d){if(!c&&b.isArray(a))return
Math.max.apply(Math,a);if(!c&&b.isEmpty(a))return-Infinity;var
e={computed:-Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b>=e.computed&&(e={value:a,computed:b})});return
e.value};b.min=function(a,c,d){if(!c&&b.isArray(a))return
Math.min.apply(Math,a);if(!c&&b.isEmpty(a))return Infinity;var
e={computed:Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b<e.computed&&(e={value:a,computed:b})});
+return e.value};b.shuffle=function(a){var
b=[],d;j(a,function(a,f){f==0?b[0]=a:(d=Math.floor(Math.random()*(f+1)),b[f]=b[d],b[d]=a)});return
b};b.sortBy=function(a,c,d){return
b.pluck(b.map(a,function(a,b,g){return{value:a,criteria:c.call(d,a,b,g)}}).sort(function(a,b){var
c=a.criteria,d=b.criteria;return
c<d?-1:c>d?1:0}),"value")};b.groupBy=function(a,c){var
d={},e=b.isFunction(c)?c:function(a){return a[c]};j(a,function(a,b){var
c=e(a,b);(d[c]||(d[c]=[])).push(a)});return d};b.sortedIndex=function(a,
+c,d){d||(d=b.identity);for(var e=0,f=a.length;e<f;){var
g=e+f>>1;d(a[g])<d(c)?e=g+1:f=g}return
e};b.toArray=function(a){return!a?[]:a.toArray?a.toArray():b.isArray(a)?i.call(a):b.isArguments(a)?i.call(a):b.values(a)};b.size=function(a){return
b.toArray(a).length};b.first=b.head=function(a,b,d){return
b!=null&&!d?i.call(a,0,b):a[0]};b.initial=function(a,b,d){return
i.call(a,0,a.length-(b==null||d?1:b))};b.last=function(a,b,d){return
b!=null&&!d?i.call(a,Math.max(a.length-b,0)):a[a.length-1]};b.rest=
+b.tail=function(a,b,d){return i.call(a,b==null||
d?1:b)};b.compact=function(a){return
b.filter(a,function(a){return!!a})};b.flatten=function(a,c){return
b.reduce(a,function(a,e){if(b.isArray(e))return
a.concat(c?e:b.flatten(e));a[a.length]=e;return
a},[])};b.without=function(a){return
b.difference(a,i.call(arguments,1))};b.uniq=b.unique=function(a,c,d){var
d=d?b.map(a,d):a,e=[];b.reduce(d,function(d,g,h){if(0==h||
(c===true?b.last(d)!=g:!b.include(d,g)))d[d.length]=g,e[e.length]=a[h];return
d},[]);
+return e};b.union=function(){return
b.uniq(b.flatten(arguments,true))};b.intersection=b.intersect=function(a){var
c=i.call(arguments,1);return b.filter(b.uniq(a),function(a){return
b.every(c,function(c){return
b.indexOf(c,a)>=0})})};b.difference=function(a){var
c=b.flatten(i.call(arguments,1));return
b.filter(a,function(a){return!b.include(c,a)})};b.zip=function(){for(var
a=i.call(arguments),c=b.max(b.pluck(a,"length")),d=Array(c),e=0;e<c;e++)d[e]=b.pluck(a,""+e);return
d};b.indexOf=function(a,c,
+d){if(a==null)return-1;var e;if(d)return
d=b.sortedIndex(a,c),a[d]===c?d:-1;if(p&&a.indexOf===p)return
a.indexOf(c);for(d=0,e=a.length;d<e;d++)if(d in a&&a[d]===c)return
d;return-1};b.lastIndexOf=function(a,b){if(a==null)return-1;if(D&&a.lastIndexOf===D)return
a.lastIndexOf(b);for(var d=a.length;d--;)if(d in a&&a[d]===b)return
d;return-1};b.range=function(a,b,d){arguments.length<=1&&(b=a||
0,a=0);for(var d=arguments[2]||
1,e=Math.max(Math.ceil((b-a)/d),0),f=0,g=Array(e);f<e;)g[f++]=a,a+=d;return
g};
+var F=function(){};b.bind=function(a,c){var d,e;if(a.bind===s&&s)return
s.apply(a,i.call(arguments,1));if(!b.isFunction(a))throw new
TypeError;e=i.call(arguments,2);return d=function(){if(!(this instanceof
d))return
a.apply(c,e.concat(i.call(arguments)));F.prototype=a.prototype;var b=new
F,g=a.apply(b,e.concat(i.call(arguments)));return
Object(g)===g?g:b}};b.bindAll=function(a){var
c=i.call(arguments,1);c.length==0&&(c=b.functions(a));j(c,function(c){a[c]=b.bind(a[c],a)});return
a};b.memoize=function(a,
+c){var d={};c||(c=b.identity);return function(){var
e=c.apply(this,arguments);return
b.has(d,e)?d[e]:d[e]=a.apply(this,arguments)}};b.delay=function(a,b){var
d=i.call(arguments,2);return setTimeout(function(){return
a.apply(a,d)},b)};b.defer=function(a){return
b.delay.apply(b,[a,1].concat(i.call(arguments,1)))};b.throttle=function(a,c){var
d,e,f,g,h,i=b.debounce(function(){h=g=false},c);return
function(){d=this;e=arguments;var b;f||
(f=setTimeout(function(){f=null;h&&a.apply(d,e);i()},c));g?h=true:
+a.apply(d,e);i();g=true}};b.debounce=function(a,b){var d;return
function(){var
e=this,f=arguments;clearTimeout(d);d=setTimeout(function(){d=null;a.apply(e,f)},b)}};b.once=function(a){var
b=false,d;return function(){if(b)return d;b=true;return
d=a.apply(this,arguments)}};b.wrap=function(a,b){return function(){var
d=[a].concat(i.call(arguments,0));return
b.apply(this,d)}};b.compose=function(){var a=arguments;return
function(){for(var
b=arguments,d=a.length-1;d>=0;d--)b=[a[d].apply(this,b)];return b[0]}};
+b.after=function(a,b){return a<=0?b():function(){if(--a<1)return
b.apply(this,arguments)}};b.keys=J||function(a){if(a!==Object(a))throw new
TypeError("Invalid object");var c=[],d;for(d in
a)b.has(a,d)&&(c[c.length]=d);return c};b.values=function(a){return
b.map(a,b.identity)};b.functions=b.methods=function(a){var c=[],d;for(d in
a)b.isFunction(a[d])&&c.push(d);return
c.sort()};b.extend=function(a){j(i.call(arguments,1),function(b){for(var d
in b)a[d]=b[d]});return a};b.defaults=function(a){j(i.call(arguments,
+1),function(b){for(var d in b)a[d]==null&&(a[d]=b[d])});return
a};b.clone=function(a){return!b.isObject(a)?a:b.isArray(a)?a.slice():b.extend({},a)};b.tap=function(a,b){b(a);return
a};b.isEqual=function(a,b){return
q(a,b,[])};b.isEmpty=function(a){if(b.isArray(a)||b.isString(a))return
a.length===0;for(var c in a)if(b.has(a,c))return false;return
true};b.isElement=function(a){return!!(a&&a.nodeType==1)};b.isArray=o||
function(a){return l.call(a)=="[object
Array]"};b.isObject=function(a){return a===Object(a)};
+b.isArguments=function(a){return l.call(a)=="[object
Arguments]"};if(!b.isArguments(arguments))b.isArguments=function(a){return!(!a|
|!b.has(a,"callee"))};b.isFunction=function(a){return l.call(a)=="[object
Function]"};b.isString=function(a){return l.call(a)=="[object
String]"};b.isNumber=function(a){return l.call(a)=="[object
Number]"};b.isNaN=function(a){return a!==a};b.isBoolean=function(a){return
a===true||a===false||l.call(a)=="[object
Boolean]"};b.isDate=function(a){return l.call(a)=="[object Date]"};
+b.isRegExp=function(a){return l.call(a)=="[object
RegExp]"};b.isNull=function(a){return
a===null};b.isUndefined=function(a){return a===void
0};b.has=function(a,b){return
I.call(a,b)};b.noConflict=function(){r._=G;return
this};b.identity=function(a){return a};b.times=function(a,b,d){for(var
e=0;e<a;e++)b.call(d,e)};b.escape=function(a){return(""+a).replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""").replace(/'/g,"'").replace(/\//g,"/")};b.mixin=function(a){j(b.functions(a),
+function(c){K(c,b[c]=a[c])})};var L=0;b.uniqueId=function(a){var
b=L++;return
a?a+b:b};b.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g};var
t=/.^/,u=function(a){return
a.replace(/\\\\/g,"\\").replace(/\\'/g,"'")};b.template=function(a,c){var
d=b.templateSettings,d="var
__p=[],print=function(){__p.push.apply(__p,arguments);};with(obj||
{}){__p.push('"+a.replace(/\\/g,"\\\\").replace(/'/g,"\\'").replace(d.escape|
|t,function(a,b){return"',_.escape("+
+u(b)+"),'"}).replace(d.interpolate||
t,function(a,b){return"',"+u(b)+",'"}).replace(d.evaluate||
t,function(a,b){return"');"+u(b).replace(/[\r\n\t]/g," ")+";__p.push('"}).replace(/\r/g,"\\r").replace(/\n/g,"\\n").replace(/\t/g,"\\t")+"');}return
__p.join('');",e=new Function("obj","_",d);return
c?e(c,b):function(a){return e.call(this,a,b)}};b.chain=function(a){return
b(a).chain()};var
m=function(a){this._wrapped=a};b.prototype=m.prototype;var
v=function(a,c){return c?b(a).chain():a},K=function(a,c){m.prototype[a]=
+function(){var a=i.call(arguments);H.call(a,this._wrapped);return
v(c.apply(b,a),this._chain)}};b.mixin(b);j("pop,push,reverse,shift,sort,splice,unshift".split(","),function(a){var
b=k[a];m.prototype[a]=function(){var
d=this._wrapped;b.apply(d,arguments);var e=d.length;(a=="shift"||
a=="splice")&&e===0&&delete d[0];return
v(d,this._chain)}});j(["concat","join","slice"],function(a){var
b=k[a];m.prototype[a]=function(){return
v(b.apply(this._wrapped,arguments),this._chain)}});m.prototype.chain=function(){this._chain=
+true;return this};m.prototype.value=function(){return
this._wrapped}}).call(this);
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_static/up-pressed.png
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,16 @@
+ PNG
+
+
+IHDR óÿa sRGB (R)Î
+é bKGD ùC>> pHYs
+×
+× B( x tIME Ú
+ , ±Ze ôIDAT8ËÍ ¿j A Æ >>* ÿ W¥Kkå ØÙ-,ÓÙ Bò y @Ò-
+ÛÙ /`cá XYh!6jÎf Gr Ol
+XvØùvæûf ¸k 2±!û óp!GOOÔ²
+ &z·(R)f 6| M (c)~¥% Ï
+`]*ð
+äÎ M] K Õ úËZ Ä 1 Eé¹ r Å%èȶÀc
+1/4 Ø mçÍ1Æ` <Ez hl^)Al Ý_Ô(c)`ÑUì
+8 `
+ Wõ + ûÓ ±áK<<¿ Îy³ · ð , 7ÃDlx 7³+÷¤ ¬ Ò -= øéAOz w IEND(R)B`
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/_static/up.png Mon
Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,17 @@
+ PNG
+
+
+IHDR óÿa sRGB (R)Î
+é bKGD ùC>> pHYs
+×
+× B( x tIME Ú !.<Í E ëIDAT8ËÍ ±N A ¿õ(R)B P\EG{ õ °³%< ñ |
éx cþþ
+
+À
+c r6 @t×;bã$ ìü;óÿ3 ø×&) ÿ ¹hÈ1ö ´ 1/4!ÁÚï<<³ Hz z@Ïý¨
+Äç °=)p
+3Ûµe° 2/ Üß´ é ( úä¹
+ ¥%øÈ^ ND^
+1/4 }3ûH1¨ ËDo Ǫ¨ IS üF Ò±? ,
+ð ì G` ÌÜß{¬vì± ^ý
+X Ù[b 1/4]à ¸ Íì&H C3{:sO&À
+ ²?,[ö ïeL# << 3/4 é IEND(R)B`
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/_static/websupport.js
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,808 @@
+/*
+ * websupport.js
+ * ~~~~~~~~~~~~~
+ *
+ * sphinx.websupport utilties for all documentation.
+ *
+ * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+(function($) {
+ $.fn.autogrow = function() {
+ return this.each(function() {
+ var textarea = this;
+
+ $.fn.autogrow.resize(textarea);
+
+ $(textarea)
+ .focus(function() {
+ textarea.interval = setInterval(function() {
+ $.fn.autogrow.resize(textarea);
+ }, 500);
+ })
+ .blur(function() {
+ clearInterval(textarea.interval);
+ });
+ });
+ };
+
+ $.fn.autogrow.resize = function(textarea) {
+ var lineHeight = parseInt($(textarea).css('line-height'), 10);
+ var lines = textarea.value.split('\n');
+ var columns = textarea.cols;
+ var lineCount = 0;
+ $.each(lines, function() {
+ lineCount += Math.ceil(this.length / columns) || 1;
+ });
+ var height = lineHeight * (lineCount + 1);
+ $(textarea).css('height', height);
+ };
+})(jQuery);
+
+(function($) {
+ var comp, by;
+
+ function init() {
+ initEvents();
+ initComparator();
+ }
+
+ function initEvents() {
+ $('a.comment-close').live("click", function(event) {
+ event.preventDefault();
+ hide($(this).attr('id').substring(2));
+ });
+ $('
a.vote').live("click", function(event) {
+ event.preventDefault();
+ handleVote($(this));
+ });
+ $('a.reply').live("click", function(event) {
+ event.preventDefault();
+ openReply($(this).attr('id').substring(2));
+ });
+ $('a.close-reply').live("click", function(event) {
+ event.preventDefault();
+ closeReply($(this).attr('id').substring(2));
+ });
+ $('a.sort-option').live("click", function(event) {
+ event.preventDefault();
+ handleReSort($(this));
+ });
+ $('a.show-proposal').live("click", function(event) {
+ event.preventDefault();
+ showProposal($(this).attr('id').substring(2));
+ });
+ $('a.hide-proposal').live("click", function(event) {
+ event.preventDefault();
+ hideProposal($(this).attr('id').substring(2));
+ });
+ $('a.show-propose-change').live("click", function(event) {
+ event.preventDefault();
+ showProposeChange($(this).attr('id').substring(2));
+ });
+ $('a.hide-propose-change').live("click", function(event) {
+ event.preventDefault();
+ hideProposeChange($(this).attr('id').substring(2));
+ });
+ $('a.accept-comment').live("click", function(event) {
+ event.preventDefault();
+ acceptComment($(this).attr('id').substring(2));
+ });
+ $('a.delete-comment').live("click", function(event) {
+ event.preventDefault();
+ deleteComment($(this).attr('id').substring(2));
+ });
+ $('a.comment-markup').live("click", function(event) {
+ event.preventDefault();
+ toggleCommentMarkupBox($(this).attr('id').substring(2));
+ });
+ }
+
+ /**
+ * Set comp, which is a comparator function used for sorting and
+ * inserting comments into the list.
+ */
+ function setComparator() {
+ // If the first three letters are "asc", sort in ascending order
+ // and remove the prefix.
+ if (by.substring(0,3) == 'asc') {
+ var i = by.substring(3);
+ comp = function(a, b) { return a[i] - b[i]; };
+ } else {
+ // Otherwise sort in descending order.
+ comp = function(a, b) { return b[by] - a[by]; };
+ }
+
+ // Reset link styles and format the selected sort option.
+ $('a.sel').attr('href', '#').removeClass('sel');
+ $('
a.by' + by).removeAttr('href').addClass('sel');
+ }
+
+ /**
+ * Create a comp function. If the user has preferences stored in
+ * the sortBy cookie, use those, otherwise use the default.
+ */
+ function initComparator() {
+ by = 'rating'; // Default to sort by rating.
+ // If the sortBy cookie is set, use that instead.
+ if (document.cookie.length > 0) {
+ var start = document.cookie.indexOf('sortBy=');
+ if (start != -1) {
+ start = start + 7;
+ var end = document.cookie.indexOf(";", start);
+ if (end == -1) {
+ end = document.cookie.length;
+ by = unescape(document.cookie.substring(start, end));
+ }
+ }
+ }
+ setComparator();
+ }
+
+ /**
+ * Show a comment div.
+ */
+ function show(id) {
+ $('#ao' + id).hide();
+ $('#ah' + id).show();
+ var context = $.extend({id: id}, opts);
+ var popup = $(renderTemplate(popupTemplate, context)).hide();
+ popup.find('textarea[name="proposal"]').hide();
+ popup.find('
a.by' + by).addClass('sel');
+ var form = popup.find('#cf' + id);
+ form.submit(function(event) {
+ event.preventDefault();
+ addComment(form);
+ });
+ $('#s' + id).after(popup);
+ popup.slideDown('fast', function() {
+ getComments(id);
+ });
+ }
+
+ /**
+ * Hide a comment div.
+ */
+ function hide(id) {
+ $('#ah' + id).hide();
+ $('#ao' + id).show();
+ var div = $('#sc' + id);
+ div.slideUp('fast', function() {
+ div.remove();
+ });
+ }
+
+ /**
+ * Perform an ajax request to get comments for a node
+ * and insert the comments into the comments tree.
+ */
+ function getComments(id) {
+ $.ajax({
+ type: 'GET',
+ url: opts.getCommentsURL,
+ data: {node: id},
+ success: function(data, textStatus, request) {
+ var ul = $('#cl' + id);
+ var speed = 100;
+ $('#cf' + id)
+ .find('textarea[name="proposal"]')
+ .data('source', data.source);
+
+ if (data.comments.length === 0) {
+ ul.html('<li>No comments yet.</li>');
+ ul.data('empty', true);
+ } else {
+ // If there are comments, sort them and put them in the list.
+ var comments = sortComments(data.comments);
+ speed = data.comments.length * 100;
+ appendComments(comments, ul);
+ ul.data('empty', false);
+ }
+ $('#cn' + id).slideUp(speed + 200);
+ ul.slideDown(speed);
+ },
+ error: function(request, textStatus, error) {
+ showError('Oops, there was a problem retrieving the comments.');
+ },
+ dataType: 'json'
+ });
+ }
+
+ /**
+ * Add a comment via ajax and insert the comment into the comment tree.
+ */
+ function addComment(form) {
+ var node_id = form.find('input[name="node"]').val();
+ var parent_id = form.find('input[name="parent"]').val();
+ var text = form.find('textarea[name="comment"]').val();
+ var proposal = form.find('textarea[name="proposal"]').val();
+
+ if (text == '') {
+ showError('Please enter a comment.');
+ return;
+ }
+
+ // Disable the form that is being submitted.
+ form.find('textarea,input').attr('disabled', 'disabled');
+
+ // Send the comment to the server.
+ $.ajax({
+ type: "POST",
+ url: opts.addCommentURL,
+ dataType: 'json',
+ data: {
+ node: node_id,
+ parent: parent_id,
+ text: text,
+ proposal: proposal
+ },
+ success: function(data, textStatus, error) {
+ // Reset the form.
+ if (node_id) {
+ hideProposeChange(node_id);
+ }
+ form.find('textarea')
+ .val('')
+ .add(form.find('input'))
+ .removeAttr('disabled');
+ var ul = $('#cl' + (node_id || parent_id));
+ if (ul.data('empty')) {
+ $(ul).empty();
+ ul.data('empty', false);
+ }
+ insertComment(data.comment);
+ var ao = $('#ao' + node_id);
+ ao.find('img').attr({'src': opts.commentBrightImage});
+ if (node_id) {
+ // if this was a "root" comment, remove the commenting box
+ // (the user can get it back by reopening the comment popup)
+ $('#ca' + node_id).slideUp();
+ }
+ },
+ error: function(request, textStatus, error) {
+ form.find('textarea,input').removeAttr('disabled');
+ showError('Oops, there was a problem adding the comment.');
+ }
+ });
+ }
+
+ /**
+ * Recursively append comments to the main comment list and children
+ * lists, creating the comment tree.
+ */
+ function appendComments(comments, ul) {
+ $.each(comments, function() {
+ var div = createCommentDiv(this);
+ ul.append($(document.createElement('li')).html(div));
+ appendComments(this.children, div.find('ul.comment-children'));
+ // To avoid stagnating data, don't store the comments children in
data.
+ this.children = null;
+ div.data('comment', this);
+ });
+ }
+
+ /**
+ * After adding a new comment, it must be inserted in the correct
+ * location in the comment tree.
+ */
+ function insertComment(comment) {
+ var div = createCommentDiv(comment);
+
+ // To avoid stagnating data, don't store the comments children in data.
+ comment.children = null;
+ div.data('comment', comment);
+
+ var ul = $('#cl' + (comment.node || comment.parent));
+ var siblings = getChildren(ul);
+
+ var li = $(document.createElement('li'));
+ li.hide();
+
+ // Determine where in the parents children list to insert this comment.
+ for(i=0; i < siblings.length; i++) {
+ if (comp(comment, siblings[i]) <= 0) {
+ $('#cd' + siblings[i].id)
+ .parent()
+ .before(li.html(div));
+ li.slideDown('fast');
+ return;
+ }
+ }
+
+ // If we get here, this comment rates lower than all the others,
+ // or it is the only comment in the list.
+ ul.append(li.html(div));
+ li.slideDown('fast');
+ }
+
+ function acceptComment(id) {
+ $.ajax({
+ type: 'POST',
+ url: opts.acceptCommentURL,
+ data: {id: id},
+ success: function(data, textStatus, request) {
+ $('#cm' + id).fadeOut('fast');
+ $('#cd' + id).removeClass('moderate');
+ },
+ error: function(request, textStatus, error) {
+ showError('Oops, there was a problem accepting the comment.');
+ }
+ });
+ }
+
+ function deleteComment(id) {
+ $.ajax({
+ type: 'POST',
+ url: opts.deleteCommentURL,
+ data: {id: id},
+ success: function(data, textStatus, request) {
+ var div = $('#cd' + id);
+ if (data == 'delete') {
+ // Moderator mode: remove the comment and all children
immediately
+ div.slideUp('fast', function() {
+ div.remove();
+ });
+ return;
+ }
+ // User mode: only mark the comment as deleted
+ div
+ .find('span.user-id:first')
+ .text('[deleted]').end()
+ .find('div.comment-text:first')
+ .text('[deleted]').end()
+ .find('#cm' + id + ', #dc' + id + ', #ac' + id + ', #rc' + id +
+ ', #sp' + id + ', #hp' + id + ', #cr' + id + ', #rl' + id)
+ .remove();
+ var comment = div.data('comment');
+ comment.username = '[deleted]';
+ comment.text = '[deleted]';
+ div.data('comment', comment);
+ },
+ error: function(request, textStatus, error) {
+ showError('Oops, there was a problem deleting the comment.');
+ }
+ });
+ }
+
+ function showProposal(id) {
+ $('#sp' + id).hide();
+ $('#hp' + id).show();
+ $('#pr' + id).slideDown('fast');
+ }
+
+ function hideProposal(id) {
+ $('#hp' + id).hide();
+ $('#sp' + id).show();
+ $('#pr' + id).slideUp('fast');
+ }
+
+ function showProposeChange(id) {
+ $('#pc' + id).hide();
+ $('#hc' + id).show();
+ var textarea = $('#pt' + id);
+ textarea.val(textarea.data('source'));
+ $.fn.autogrow.resize(textarea[0]);
+ textarea.slideDown('fast');
+ }
+
+ function hideProposeChange(id) {
+ $('#hc' + id).hide();
+ $('#pc' + id).show();
+ var textarea = $('#pt' + id);
+ textarea.val('').removeAttr('disabled');
+ textarea.slideUp('fast');
+ }
+
+ function toggleCommentMarkupBox(id) {
+ $('#mb' + id).toggle();
+ }
+
+ /** Handle when the user clicks on a sort by link. */
+ function handleReSort(link) {
+ var classes = link.attr('class').split(/\s+/);
+ for (var i=0; i<classes.length; i++) {
+ if (classes[i] != 'sort-option') {
+ by = classes[i].substring(2);
+ }
+ }
+ setComparator();
+ // Save/update the sortBy cookie.
+ var expiration = new Date();
+ expiration.setDate(expiration.getDate() + 365);
+ document.cookie= 'sortBy=' + escape(by) +
+ ';expires=' + expiration.toUTCString();
+ $('ul.comment-ul').each(function(index, ul) {
+ var comments = getChildren($(ul), true);
+ comments = sortComments(comments);
+ appendComments(comments, $(ul).empty());
+ });
+ }
+
+ /**
+ * Function to process a vote when a user clicks an arrow.
+ */
+ function handleVote(link) {
+ if (!opts.voting) {
+ showError("You'll need to login to vote.");
+ return;
+ }
+
+ var id = link.attr('id');
+ if (!id) {
+ // Didn't click on one of the voting arrows.
+ return;
+ }
+ // If it is an unvote, the new vote value is 0,
+ // Otherwise it's 1 for an upvote, or -1 for a downvote.
+ var value = 0;
+ if (id.charAt(1) != 'u') {
+ value = id.charAt(0) == 'u' ? 1 : -1;
+ }
+ // The data to be sent to the server.
+ var d = {
+ comment_id: id.substring(2),
+ value: value
+ };
+
+ // Swap the vote and unvote links.
+ link.hide();
+ $('#' + id.charAt(0) + (id.charAt(1) == 'u' ? 'v' : 'u') +
d.comment_id)
+ .show();
+
+ // The div the comment is displayed in.
+ var div = $('div#cd' + d.comment_id);
+ var data = div.data('comment');
+
+ // If this is not an unvote, and the other vote arrow has
+ // already been pressed, unpress it.
+ if ((d.value !== 0) && (
data.vote === d.value * -1)) {
+ $('#' + (d.value == 1 ? 'd' : 'u') + 'u' + d.comment_id).hide();
+ $('#' + (d.value == 1 ? 'd' : 'u') + 'v' + d.comment_id).show();
+ }
+
+ // Update the comments rating in the local data.
+ data.rating += (
data.vote === 0) ? d.value : (d.value -
data.vote);
+
data.vote = d.value;
+ div.data('comment', data);
+
+ // Change the rating text.
+ div.find('.rating:first')
+ .text(data.rating + ' point' + (data.rating == 1 ? '' : 's'));
+
+ // Send the vote information to the server.
+ $.ajax({
+ type: "POST",
+ url: opts.processVoteURL,
+ data: d,
+ error: function(request, textStatus, error) {
+ showError('Oops, there was a problem casting that vote.');
+ }
+ });
+ }
+
+ /**
+ * Open a reply form used to reply to an existing comment.
+ */
+ function openReply(id) {
+ // Swap out the reply link for the hide link
+ $('#rl' + id).hide();
+ $('#cr' + id).show();
+
+ // Add the reply li to the children ul.
+ var div = $(renderTemplate(replyTemplate, {id: id})).hide();
+ $('#cl' + id)
+ .prepend(div)
+ // Setup the submit handler for the reply form.
+ .find('#rf' + id)
+ .submit(function(event) {
+ event.preventDefault();
+ addComment($('#rf' + id));
+ closeReply(id);
+ })
+ .find('input[type=button]')
+ .click(function() {
+ closeReply(id);
+ });
+ div.slideDown('fast', function() {
+ $('#rf' + id).find('textarea').focus();
+ });
+ }
+
+ /**
+ * Close the reply form opened with openReply.
+ */
+ function closeReply(id) {
+ // Remove the reply div from the DOM.
+ $('#rd' + id).slideUp('fast', function() {
+ $(this).remove();
+ });
+
+ // Swap out the hide link for the reply link
+ $('#cr' + id).hide();
+ $('#rl' + id).show();
+ }
+
+ /**
+ * Recursively sort a tree of comments using the comp comparator.
+ */
+ function sortComments(comments) {
+ comments.sort(comp);
+ $.each(comments, function() {
+ this.children = sortComments(this.children);
+ });
+ return comments;
+ }
+
+ /**
+ * Get the children comments from a ul. If recursive is true,
+ * recursively include childrens' children.
+ */
+ function getChildren(ul, recursive) {
+ var children = [];
+ ul.children().children("[id^='cd']")
+ .each(function() {
+ var comment = $(this).data('comment');
+ if (recursive)
+ comment.children = getChildren($(this).find('#cl' +
comment.id),
true);
+ children.push(comment);
+ });
+ return children;
+ }
+
+ /** Create a div to display a comment in. */
+ function createCommentDiv(comment) {
+ if (!comment.displayed && !opts.moderator) {
+ return $('<div class="moderate">Thank you! Your comment will show
up '
+ + 'once it is has been approved by a moderator.</div>');
+ }
+ // Prettify the comment rating.
+ comment.pretty_rating = comment.rating + ' point' +
+ (comment.rating == 1 ? '' : 's');
+ // Make a class (for displaying not yet moderated comments differently)
+ comment.css_class = comment.displayed ? '' : ' moderate';
+ // Create a div for this comment.
+ var context = $.extend({}, opts, comment);
+ var div = $(renderTemplate(commentTemplate, context));
+
+ // If the user has voted on this comment, highlight the correct arrow.
+ if (
comment.vote) {
+ var direction = (
comment.vote == 1) ? 'u' : 'd';
+ div.find('#' + direction + 'v' +
comment.id).hide();
+ div.find('#' + direction + 'u' +
comment.id).show();
+ }
+
+ if (opts.moderator || comment.text != '[deleted]') {
+ div.find('a.reply').show();
+ if (comment.proposal_diff)
+ div.find('#sp' +
comment.id).show();
+ if (opts.moderator && !comment.displayed)
+ div.find('#cm' +
comment.id).show();
+ if (opts.moderator || (opts.username == comment.username))
+ div.find('#dc' +
comment.id).show();
+ }
+ return div;
+ }
+
+ /**
+ * A simple template renderer. Placeholders such as <%id%> are replaced
+ * by context['id'] with items being escaped. Placeholders such as <#id#>
+ * are not escaped.
+ */
+ function renderTemplate(template, context) {
+ var esc = $(document.createElement('div'));
+
+ function handle(ph, escape) {
+ var cur = context;
+ $.each(ph.split('.'), function() {
+ cur = cur[this];
+ });
+ return escape ? esc.text(cur || "").html() : cur;
+ }
+
+ return template.replace(/<([%#])([\w\.]*)\1>/g, function() {
+ return handle(arguments[2], arguments[1] == '%' ? true : false);
+ });
+ }
+
+ /** Flash an error message briefly. */
+ function showError(message) {
+ $(document.createElement('div')).attr({'class': 'popup-error'})
+ .append($(document.createElement('div'))
+ .attr({'class': 'error-message'}).text(message))
+ .appendTo('body')
+ .fadeIn("slow")
+ .delay(2000)
+ .fadeOut("slow");
+ }
+
+ /** Add a link the user uses to open the comments popup. */
+ $.fn.comment = function() {
+ return this.each(function() {
+ var id = $(this).attr('id').substring(1);
+ var count = COMMENT_METADATA[id];
+ var title = count + ' comment' + (count == 1 ? '' : 's');
+ var image = count > 0 ? opts.commentBrightImage : opts.commentImage;
+ var addcls = count == 0 ? ' nocomment' : '';
+ $(this)
+ .append(
+ $(document.createElement('a')).attr({
+ href: '#',
+ 'class': 'sphinx-comment-open' + addcls,
+ id: 'ao' + id
+ })
+ .append($(document.createElement('img')).attr({
+ src: image,
+ alt: 'comment',
+ title: title
+ }))
+ .click(function(event) {
+ event.preventDefault();
+ show($(this).attr('id').substring(2));
+ })
+ )
+ .append(
+ $(document.createElement('a')).attr({
+ href: '#',
+ 'class': 'sphinx-comment-close hidden',
+ id: 'ah' + id
+ })
+ .append($(document.createElement('img')).attr({
+ src: opts.closeCommentImage,
+ alt: 'close',
+ title: 'close'
+ }))
+ .click(function(event) {
+ event.preventDefault();
+ hide($(this).attr('id').substring(2));
+ })
+ );
+ });
+ };
+
+ var opts = {
+ processVoteURL: '/_process_vote',
+ addCommentURL: '/_add_comment',
+ getCommentsURL: '/_get_comments',
+ acceptCommentURL: '/_accept_comment',
+ deleteCommentURL: '/_delete_comment',
+ commentImage: '/static/_static/comment.png',
+ closeCommentImage: '/static/_static/comment-close.png',
+ loadingImage: '/static/_static/ajax-loader.gif',
+ commentBrightImage: '/static/_static/comment-bright.png',
+ upArrow: '/static/_static/up.png',
+ downArrow: '/static/_static/down.png',
+ upArrowPressed: '/static/_static/up-pressed.png',
+ downArrowPressed: '/static/_static/down-pressed.png',
+ voting: false,
+ moderator: false
+ };
+
+ if (typeof COMMENT_OPTIONS != "undefined") {
+ opts = jQuery.extend(opts, COMMENT_OPTIONS);
+ }
+
+ var popupTemplate = '\
+ <div class="sphinx-comments" id="sc<%id%>">\
+ <p class="sort-options">\
+ Sort by:\
+ <a href="#" class="sort-option byrating">best rated</a>\
+ <a href="#" class="sort-option byascage">newest</a>\
+ <a href="#" class="sort-option byage">oldest</a>\
+ </p>\
+ <div class="comment-header">Comments</div>\
+ <div class="comment-loading" id="cn<%id%>">\
+ loading comments... <img src="<%loadingImage%>" alt="" /></div>\
+ <ul id="cl<%id%>" class="comment-ul"></ul>\
+ <div id="ca<%id%>">\
+ <p class="add-a-comment">Add a comment\
+ (<a href="#" class="comment-markup" id="ab<%id%>">markup</a>):</p>\
+ <div class="comment-markup-box" id="mb<%id%>">\
+ reStructured text markup: <i>*emph*</i>, <b>**strong**</b>, \
+ <tt>``code``</tt>, \
+ code blocks: <tt>::</tt> and an indented block after blank
line</div>\
+ <form method="post" id="cf<%id%>" class="comment-form" action="">\
+ <textarea name="comment" cols="80"></textarea>\
+ <p class="propose-button">\
+ <a href="#" id="pc<%id%>" class="show-propose-change">\
+ Propose a change ▹\
+ </a>\
+ <a href="#" id="hc<%id%>" class="hide-propose-change">\
+ Propose a change ▿\
+ </a>\
+ </p>\
+ <textarea name="proposal" id="pt<%id%>" cols="80"\
+ spellcheck="false"></textarea>\
+ <input type="submit" value="Add comment" />\
+ <input type="hidden" name="node" value="<%id%>" />\
+ <input type="hidden" name="parent" value="" />\
+ </form>\
+ </div>\
+ </div>';
+
+ var commentTemplate = '\
+ <div id="cd<%id%>" class="sphinx-comment<%css_class%>">\
+ <div class="vote">\
+ <div class="arrow">\
+ <a href="#" id="uv<%id%>" class="vote" title="vote up">\
+ <img src="<%upArrow%>" />\
+ </a>\
+ <a href="#" id="uu<%id%>" class="un vote" title="vote up">\
+ <img src="<%upArrowPressed%>" />\
+ </a>\
+ </div>\
+ <div class="arrow">\
+ <a href="#" id="dv<%id%>" class="vote" title="vote down">\
+ <img src="<%downArrow%>" id="da<%id%>" />\
+ </a>\
+ <a href="#" id="du<%id%>" class="un vote" title="vote down">\
+ <img src="<%downArrowPressed%>" />\
+ </a>\
+ </div>\
+ </div>\
+ <div class="comment-content">\
+ <p class="tagline comment">\
+ <span class="user-id"><%username%></span>\
+ <span class="rating"><%pretty_rating%></span>\
+ <span class="delta"><%time.delta%></span>\
+ </p>\
+ <div class="comment-text comment"><#text#></div>\
+ <p class="comment-opts comment">\
+ <a href="#" class="reply hidden" id="rl<%id%>">reply ▹</a>\
+ <a href="#" class="close-reply" id="cr<%id%>">reply ▿</a>\
+ <a href="#" id="sp<%id%>" class="show-proposal">proposal
▹</a>\
+ <a href="#" id="hp<%id%>" class="hide-proposal">proposal
▿</a>\
+ <a href="#" id="dc<%id%>" class="delete-comment
hidden">delete</a>\
+ <span id="cm<%id%>" class="moderation hidden">\
+ <a href="#" id="ac<%id%>" class="accept-comment">accept</a>\
+ </span>\
+ </p>\
+ <pre class="proposal" id="pr<%id%>">\
+<#proposal_diff#>\
+ </pre>\
+ <ul class="comment-children" id="cl<%id%>"></ul>\
+ </div>\
+ <div class="clearleft"></div>\
+ </div>\
+ </div>';
+
+ var replyTemplate = '\
+ <li>\
+ <div class="reply-div" id="rd<%id%>">\
+ <form id="rf<%id%>">\
+ <textarea name="comment" cols="80"></textarea>\
+ <input type="submit" value="Add reply" />\
+ <input type="button" value="Cancel" />\
+ <input type="hidden" name="parent" value="<%id%>" />\
+ <input type="hidden" name="node" value="" />\
+ </form>\
+ </div>\
+ </li>';
+
+ $(document).ready(function() {
+ init();
+ });
+})(jQuery);
+
+$(document).ready(function() {
+ // add comment anchors for all paragraphs that are commentable
+ $('.sphinx-has-comment').comment();
+
+ // highlight search words in search results
+ $("div.context").each(function() {
+ var params = $.getQueryParameters();
+ var terms = (params.q) ? params.q[0].split(/\s+/) : [];
+ var result = $(this);
+ $.each(terms, function() {
+ result.highlightText(this.toLowerCase(), 'highlighted');
+ });
+ });
+
+ // directly open comment window if requested
+ var anchor = document.location.hash;
+ if (anchor.substring(0, 9) == '#comment-') {
+ $('#ao' + anchor.substring(9)).click();
+ document.location.hash = '#s' + anchor.substring(9);
+ }
+});
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/genindex.html Mon
Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,679 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="
http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Index — Roster Config Manager v0.18 documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: 'v0.18',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <link rel="top" title="Roster Config Manager v0.18 documentation"
href="index.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="#" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+
+<h1 id="index">Index</h1>
+
+<div class="genindex-jumpbox">
+ <a href="#A"><strong>A</strong></a>
+ | <a href="#B"><strong>B</strong></a>
+ | <a href="#C"><strong>C</strong></a>
+ | <a href="#D"><strong>D</strong></a>
+ | <a href="#E"><strong>E</strong></a>
+ | <a href="#F"><strong>F</strong></a>
+ | <a href="#G"><strong>G</strong></a>
+ | <a href="#I"><strong>I</strong></a>
+ | <a href="#L"><strong>L</strong></a>
+ | <a href="#M"><strong>M</strong></a>
+ | <a href="#N"><strong>N</strong></a>
+ | <a href="#P"><strong>P</strong></a>
+ | <a href="#Q"><strong>Q</strong></a>
+ | <a href="#R"><strong>R</strong></a>
+ | <a href="#S"><strong>S</strong></a>
+ | <a href="#T"><strong>T</strong></a>
+ | <a href="#U"><strong>U</strong></a>
+ | <a href="#W"><strong>W</strong></a>
+ | <a href="#Z"><strong>Z</strong></a>
+
+</div>
+<h2 id="A">A</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.BindTreeExport.AddToTarFile">AddToTarFile()
(roster_config_manager.__init__.BindTreeExport method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.AddToTarFile">(roster_config_manager.tree_exporter.BindTreeExport
method)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+</tr></table>
+
+<h2 id="B">B</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.BIND_OPTION_CLAUSES">BIND_OPTION_CLAUSES
(roster_config_manager.__init__.ConfigLib attribute)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.BIND_OPTION_CLAUSES">(roster_config_manager.config_lib.ConfigLib
attribute)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.BindTreeExport">BindTreeExport
(class in roster_config_manager.__init__)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport">(class
in roster_config_manager.tree_exporter)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+</tr></table>
+
+<h2 id="C">C</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.ChangesNotFoundError">ChangesNotFoundError</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.CheckDnsServer">CheckDnsServer()
(roster_config_manager.__init__.ConfigLib method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.CheckDnsServer">(roster_config_manager.config_lib.ConfigLib
method)</a>
+ </dt>
+
+ </dl></dd>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.CHECKZONE_ARGS_DICT">CHECKZONE_ARGS_DICT
(roster_config_manager.__init__.ConfigLib attribute)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.CHECKZONE_ARGS_DICT">(roster_config_manager.config_lib.ConfigLib
attribute)</a>
+ </dt>
+
+ </dl></dd>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.COMMANDS_CONVERT_DICT">COMMANDS_CONVERT_DICT
(roster_config_manager.__init__.ConfigLib attribute)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.COMMANDS_CONVERT_DICT">(roster_config_manager.config_lib.ConfigLib
attribute)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib">ConfigLib
(class in roster_config_manager.__init__)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib">(class
in roster_config_manager.config_lib)</a>
+ </dt>
+
+ </dl></dd>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigManagerError">ConfigManagerError</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.BindTreeExport.CookData">CookData()
(roster_config_manager.__init__.BindTreeExport method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.CookData">(roster_config_manager.tree_exporter.BindTreeExport
method)</a>
+ </dt>
+
+ </dl></dd>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.BindTreeExport.CookRawDump">CookRawDump()
(roster_config_manager.__init__.BindTreeExport method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.CookRawDump">(roster_config_manager.tree_exporter.BindTreeExport
method)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+</tr></table>
+
+<h2 id="D">D</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.dns_query_lib.DnsQuery">DnsQuery()
(in module roster_config_manager.dns_query_lib)</a>
+ </dt>
+
+ </dl></td>
+</tr></table>
+
+<h2 id="E">E</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.Error">Error</a>,
<a
href="roster_config_manager.html#roster_config_manager.zone_exporter_lib.Error">[1]</a>,
<a
href="roster_config_manager.html#roster_config_manager.zone_importer_lib.Error">[2]</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.BindTreeExport.ExportAllBindTrees">ExportAllBindTrees()
(roster_config_manager.__init__.BindTreeExport method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.ExportAllBindTrees">(roster_config_manager.tree_exporter.BindTreeExport
method)</a>
+ </dt>
+
+ </dl></dd>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ExporterAuditIdError">ExporterAuditIdError</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ExporterFileError">ExporterFileError</a>
+ </dt>
+
+ </dl></td>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ExporterFileNameError">ExporterFileNameError</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ExporterListFileError">ExporterListFileError</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ExporterNoFileError">ExporterNoFileError</a>
+ </dt>
+
+ </dl></td>
+</tr></table>
+
+<h2 id="F">F</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.FindAllDnsServers">FindAllDnsServers()
(roster_config_manager.__init__.ConfigLib method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.FindAllDnsServers">(roster_config_manager.config_lib.ConfigLib
method)</a>
+ </dt>
+
+ </dl></dd>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.FindDnsTreeFilename">FindDnsTreeFilename()
(roster_config_manager.__init__.ConfigLib method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.FindDnsTreeFilename">(roster_config_manager.config_lib.ConfigLib
method)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.FindNewestDnsTreeFilename">FindNewestDnsTreeFilename()
(roster_config_manager.__init__.ConfigLib method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.FindNewestDnsTreeFilename">(roster_config_manager.config_lib.ConfigLib
method)</a>
+ </dt>
+
+ </dl></dd>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.zone_exporter_lib.FormatRecordsForZone">FormatRecordsForZone()
(in module roster_config_manager.zone_exporter_lib)</a>
+ </dt>
+
+ </dl></td>
+</tr></table>
+
+<h2 id="G">G</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.GenerateAdditionalNamedCheckzoneArgs">GenerateAdditionalNamedCheckzoneArgs()
(roster_config_manager.__init__.ConfigLib method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.GenerateAdditionalNamedCheckzoneArgs">(roster_config_manager.config_lib.ConfigLib
method)</a>
+ </dt>
+
+ </dl></dd>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.GetDnsServerInfo">GetDnsServerInfo()
(roster_config_manager.__init__.ConfigLib method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.GetDnsServerInfo">(roster_config_manager.config_lib.ConfigLib
method)</a>
+ </dt>
+
+ </dl></dd>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.GetNamedZoneToolArgs">GetNamedZoneToolArgs()
(roster_config_manager.__init__.ConfigLib method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.GetNamedZoneToolArgs">(roster_config_manager.config_lib.ConfigLib
method)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.BindTreeExport.GetRawData">GetRawData()
(roster_config_manager.__init__.BindTreeExport method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.GetRawData">(roster_config_manager.tree_exporter.BindTreeExport
method)</a>
+ </dt>
+
+ </dl></dd>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.GetZoneList">GetZoneList()
(roster_config_manager.__init__.ConfigLib method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.GetZoneList">(roster_config_manager.config_lib.ConfigLib
method)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+</tr></table>
+
+<h2 id="I">I</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.zone_importer_lib.IncludeError">IncludeError</a>
+ </dt>
+
+ </dl></td>
+</tr></table>
+
+<h2 id="L">L</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.BindTreeExport.ListACLNamesByView">ListACLNamesByView()
(roster_config_manager.__init__.BindTreeExport method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.ListACLNamesByView">(roster_config_manager.tree_exporter.BindTreeExport
method)</a>
+ </dt>
+
+ </dl></dd>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.BindTreeExport.ListLatestNamedConfGlobalOptions">ListLatestNamedConfGlobalOptions()
(roster_config_manager.__init__.BindTreeExport method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.ListLatestNamedConfGlobalOptions">(roster_config_manager.tree_exporter.BindTreeExport
method)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.BindTreeExport.ListRecordArgumentDefinitions">ListRecordArgumentDefinitions()
(roster_config_manager.__init__.BindTreeExport method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.ListRecordArgumentDefinitions">(roster_config_manager.tree_exporter.BindTreeExport
method)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+</tr></table>
+
+<h2 id="M">M</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.MaintenanceError">MaintenanceError</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.BindTreeExport.MakeNamedConf">MakeNamedConf()
(roster_config_manager.__init__.BindTreeExport method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.MakeNamedConf">(roster_config_manager.tree_exporter.BindTreeExport
method)</a>
+ </dt>
+
+ </dl></dd>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.zone_importer_lib.ZoneImport.MakeRecordsFromZone">MakeRecordsFromZone()
(roster_config_manager.zone_importer_lib.ZoneImport method)</a>
+ </dt>
+
+ </dl></td>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.zone_exporter_lib.MakeZoneString">MakeZoneString()
(in module roster_config_manager.zone_exporter_lib)</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.MergeOptionsDicts">MergeOptionsDicts()
(roster_config_manager.__init__.ConfigLib method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.MergeOptionsDicts">(roster_config_manager.config_lib.ConfigLib
method)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+</tr></table>
+
+<h2 id="N">N</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.BindTreeExport.NamedHeaderChangeDirectory">NamedHeaderChangeDirectory()
(roster_config_manager.__init__.BindTreeExport method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.NamedHeaderChangeDirectory">(roster_config_manager.tree_exporter.BindTreeExport
method)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+</tr></table>
+
+<h2 id="P">P</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.db_recovery.Recover.PushBackup">PushBackup()
(roster_config_manager.db_recovery.Recover method)</a>
+ </dt>
+
+ </dl></td>
+</tr></table>
+
+<h2 id="Q">Q</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.QueryCheckError">QueryCheckError</a>
+ </dt>
+
+ </dl></td>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.dns_query_lib.QueryFromZoneFile">QueryFromZoneFile()
(in module roster_config_manager.dns_query_lib)</a>
+ </dt>
+
+ </dl></td>
+</tr></table>
+
+<h2 id="R">R</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.db_recovery.Recover">Recover
(class in roster_config_manager.db_recovery)</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.zone_importer_lib.ZoneImport.ReverseZoneToCIDRBlock">ReverseZoneToCIDRBlock()
(roster_config_manager.zone_importer_lib.ZoneImport method)</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#module-roster_config_manager.__init__">roster_config_manager.__init__
(module)</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#module-roster_config_manager.config_lib">roster_config_manager.config_lib
(module)</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#module-roster_config_manager.db_recovery">roster_config_manager.db_recovery
(module)</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#module-roster_config_manager.dns_query_lib">roster_config_manager.dns_query_lib
(module)</a>
+ </dt>
+
+ </dl></td>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#module-roster_config_manager.tree_exporter">roster_config_manager.tree_exporter
(module)</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#module-roster_config_manager.zone_exporter_lib">roster_config_manager.zone_exporter_lib
(module)</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#module-roster_config_manager.zone_importer_lib">roster_config_manager.zone_importer_lib
(module)</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.db_recovery.Recover.RunAuditRange">RunAuditRange()
(roster_config_manager.db_recovery.Recover method)</a>
+ </dt>
+
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.db_recovery.Recover.RunAuditStep">RunAuditStep()
(roster_config_manager.db_recovery.Recover method)</a>
+ </dt>
+
+ </dl></td>
+</tr></table>
+
+<h2 id="S">S</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ServerCheckError">ServerCheckError</a>
+ </dt>
+
+ </dl></td>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.BindTreeExport.SortRecords">SortRecords()
(roster_config_manager.__init__.BindTreeExport method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.tree_exporter.BindTreeExport.SortRecords">(roster_config_manager.tree_exporter.BindTreeExport
method)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+</tr></table>
+
+<h2 id="T">T</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.TarDnsBindFiles">TarDnsBindFiles()
(roster_config_manager.__init__.ConfigLib method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.TarDnsBindFiles">(roster_config_manager.config_lib.ConfigLib
method)</a>
+ </dt>
+
+ </dl></dd>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.TarDnsTree">TarDnsTree()
(roster_config_manager.__init__.ConfigLib method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.TarDnsTree">(roster_config_manager.config_lib.ConfigLib
method)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.ToolList">ToolList
(roster_config_manager.__init__.ConfigLib attribute)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.ToolList">(roster_config_manager.config_lib.ConfigLib
attribute)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+</tr></table>
+
+<h2 id="U">U</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.UnTarDnsTree">UnTarDnsTree()
(roster_config_manager.__init__.ConfigLib method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.UnTarDnsTree">(roster_config_manager.config_lib.ConfigLib
method)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+</tr></table>
+
+<h2 id="W">W</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.__init__.ConfigLib.WriteDnsServerInfo">WriteDnsServerInfo()
(roster_config_manager.__init__.ConfigLib method)</a>
+ </dt>
+
+ <dd><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.config_lib.ConfigLib.WriteDnsServerInfo">(roster_config_manager.config_lib.ConfigLib
method)</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+</tr></table>
+
+<h2 id="Z">Z</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.zone_exporter_lib.ZoneError">ZoneError</a>
+ </dt>
+
+ </dl></td>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a
href="roster_config_manager.html#roster_config_manager.zone_importer_lib.ZoneImport">ZoneImport
(class in roster_config_manager.zone_importer_lib)</a>
+ </dt>
+
+ </dl></td>
+</tr></table>
+
+
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+
+
+
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="#" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2013, Purdue University.
+ Created using <a href="
http://sphinx-doc.org/">Sphinx</a> 1.2b1.
+ </div>
+ </body>
+</html>
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/index.html Mon Aug
19 17:06:11 2013 UTC
@@ -0,0 +1,137 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="
http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Welcome to Roster Config Manager's documentation! —
Roster Config Manager v0.18 documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: 'v0.18',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <link rel="top" title="Roster Config Manager v0.18 documentation"
href="#" />
+ <link rel="next" title="roster_config_manager Package"
href="roster_config_manager.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li class="right" >
+ <a href="roster_config_manager.html"
title="roster_config_manager Package"
+ accesskey="N">next</a> |</li>
+ <li><a href="#">Roster Config Manager v0.18 documentation</a>
»</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <div class="section"
id="welcome-to-roster-config-manager-s-documentation">
+<h1>Welcome to Roster Config Manager’s documentation!<a
class="headerlink" href="#welcome-to-roster-config-manager-s-documentation"
title="Permalink to this headline">¶</a></h1>
+<p>Contents:</p>
+<div class="toctree-wrapper compound">
+<ul>
+<li class="toctree-l1"><a class="reference internal"
href="roster_config_manager.html">roster_config_manager Package</a><ul>
+<li class="toctree-l2"><a class="reference internal"
href="roster_config_manager.html#id1"><tt class="docutils literal"><span
class="pre">roster_config_manager</span></tt> Package</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="roster_config_manager.html#module-roster_config_manager.config_lib"><tt
class="docutils literal"><span class="pre">config_lib</span></tt>
Module</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="roster_config_manager.html#module-roster_config_manager.db_recovery"><tt
class="docutils literal"><span class="pre">db_recovery</span></tt>
Module</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="roster_config_manager.html#module-roster_config_manager.dns_query_lib"><tt
class="docutils literal"><span class="pre">dns_query_lib</span></tt>
Module</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="roster_config_manager.html#module-roster_config_manager.tree_exporter"><tt
class="docutils literal"><span class="pre">tree_exporter</span></tt>
Module</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="roster_config_manager.html#module-roster_config_manager.zone_exporter_lib"><tt
class="docutils literal"><span class="pre">zone_exporter_lib</span></tt>
Module</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="roster_config_manager.html#module-roster_config_manager.zone_importer_lib"><tt
class="docutils literal"><span class="pre">zone_importer_lib</span></tt>
Module</a></li>
+</ul>
+</li>
+</ul>
+</div>
+</div>
+<div class="section" id="indices-and-tables">
+<h1>Indices and tables<a class="headerlink" href="#indices-and-tables"
title="Permalink to this headline">¶</a></h1>
+<ul class="simple">
+<li><a class="reference internal"
href="genindex.html"><em>Index</em></a></li>
+<li><a class="reference internal" href="py-modindex.html"><em>Module
Index</em></a></li>
+<li><a class="reference internal" href="search.html"><em>Search
Page</em></a></li>
+</ul>
+</div>
+
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+ <h3><a href="#">Table Of Contents</a></h3>
+ <ul>
+<li><a class="reference internal" href="#">Welcome to Roster Config
Manager’s documentation!</a><ul>
+</ul>
+</li>
+<li><a class="reference internal" href="#indices-and-tables">Indices and
tables</a></li>
+</ul>
+
+ <h4>Next topic</h4>
+ <p class="topless"><a href="roster_config_manager.html"
+ title="next chapter">roster_config_manager
Package</a></p>
+ <h3>This Page</h3>
+ <ul class="this-page-menu">
+ <li><a href="_sources/index.txt"
+ rel="nofollow">Show Source</a></li>
+ </ul>
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li class="right" >
+ <a href="roster_config_manager.html"
title="roster_config_manager Package"
+ >next</a> |</li>
+ <li><a href="#">Roster Config Manager v0.18 documentation</a>
»</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2013, Purdue University.
+ Created using <a href="
http://sphinx-doc.org/">Sphinx</a> 1.2b1.
+ </div>
+ </body>
+</html>
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/objects.inv Mon Aug
19 17:06:11 2013 UTC
Binary file, no diff available.
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/py-modindex.html Mon
Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,144 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="
http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Python Module Index — Roster Config Manager v0.18
documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: 'v0.18',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <link rel="top" title="Roster Config Manager v0.18 documentation"
href="index.html" />
+
+
+
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="#" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+
+ <h1>Python Module Index</h1>
+
+ <div class="modindex-jumpbox">
+ <a href="#cap-r"><strong>r</strong></a>
+ </div>
+
+ <table class="indextable modindextable" cellspacing="0" cellpadding="2">
+ <tr class="pcap"><td></td><td> </td><td></td></tr>
+ <tr class="cap" id="cap-r"><td></td><td>
+ <strong>r</strong></td><td></td></tr>
+ <tr>
+ <td><img src="_static/minus.png" class="toggler"
+ id="toggle-1" style="display: none" alt="-" /></td>
+ <td>
+ <tt class="xref">roster_config_manager</tt></td><td>
+ <em></em></td></tr>
+ <tr class="cg-1">
+ <td></td>
+ <td>
+ <a
href="roster_config_manager.html#module-roster_config_manager.__init__"><tt
class="xref">roster_config_manager.__init__</tt></a></td><td>
+ <em></em></td></tr>
+ <tr class="cg-1">
+ <td></td>
+ <td>
+ <a
href="roster_config_manager.html#module-roster_config_manager.config_lib"><tt
class="xref">roster_config_manager.config_lib</tt></a></td><td>
+ <em></em></td></tr>
+ <tr class="cg-1">
+ <td></td>
+ <td>
+ <a
href="roster_config_manager.html#module-roster_config_manager.db_recovery"><tt
class="xref">roster_config_manager.db_recovery</tt></a></td><td>
+ <em></em></td></tr>
+ <tr class="cg-1">
+ <td></td>
+ <td>
+ <a
href="roster_config_manager.html#module-roster_config_manager.dns_query_lib"><tt
class="xref">roster_config_manager.dns_query_lib</tt></a></td><td>
+ <em></em></td></tr>
+ <tr class="cg-1">
+ <td></td>
+ <td>
+ <a
href="roster_config_manager.html#module-roster_config_manager.tree_exporter"><tt
class="xref">roster_config_manager.tree_exporter</tt></a></td><td>
+ <em></em></td></tr>
+ <tr class="cg-1">
+ <td></td>
+ <td>
+ <a
href="roster_config_manager.html#module-roster_config_manager.zone_exporter_lib"><tt
class="xref">roster_config_manager.zone_exporter_lib</tt></a></td><td>
+ <em></em></td></tr>
+ <tr class="cg-1">
+ <td></td>
+ <td>
+ <a
href="roster_config_manager.html#module-roster_config_manager.zone_importer_lib"><tt
class="xref">roster_config_manager.zone_importer_lib</tt></a></td><td>
+ <em></em></td></tr>
+ </table>
+
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="#" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2013, Purdue University.
+ Created using <a href="
http://sphinx-doc.org/">Sphinx</a> 1.2b1.
+ </div>
+ </body>
+</html>
=======================================
--- /dev/null
+++
/tags/release-0.18/roster-config-manager/docs/html/roster_config_manager.html
Mon Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,1637 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="
http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>roster_config_manager Package — Roster Config Manager
v0.18 documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: 'v0.18',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <link rel="top" title="Roster Config Manager v0.18 documentation"
href="index.html" />
+ <link rel="prev" title="Welcome to Roster Config Manager's
documentation!" href="index.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li class="right" >
+ <a href="index.html" title="Welcome to Roster Config Manager's
documentation!"
+ accesskey="P">previous</a> |</li>
+ <li><a href="index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <div class="section" id="roster-config-manager-package">
+<h1>roster_config_manager Package<a class="headerlink"
href="#roster-config-manager-package" title="Permalink to this
headline">¶</a></h1>
+<div class="section" id="id1">
+<h2><tt class="xref py py-mod docutils literal"><span
class="pre">roster_config_manager</span></tt> Package<a class="headerlink"
href="#id1" title="Permalink to this headline">¶</a></h2>
+<span class="target"
id="module-roster_config_manager.__init__"></span><p>Toplevel RosterCore
API. This presents entities to external consumers.</p>
+<dl class="class">
+<dt id="roster_config_manager.__init__.ConfigLib">
+<em class="property">class </em><tt
class="descclassname">roster_config_manager.__init__.</tt><tt
class="descname">ConfigLib</tt><big>(</big><em>config_file</em><big>)</big><a
class="headerlink" href="#roster_config_manager.__init__.ConfigLib"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Bases: <tt class="xref py py-class docutils literal"><span
class="pre">object</span></tt></p>
+<p>This class checks a DNS server for the functionality required to push
+zone files to it</p>
+<dl class="attribute">
+<dt id="roster_config_manager.__init__.ConfigLib.BIND_OPTION_CLAUSES">
+<tt class="descname">BIND_OPTION_CLAUSES</tt><em class="property"> =
{'check-wildcard': 'yes', 'check-names': 'warn', 'check-integrity': 'yes', 'check-mx': 'warn', 'check-dup-records': 'warn', 'check-siblings': 'yes', 'check-mx-cname': 'warn', 'check-srv-cname': 'warn'}</em><a
class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.BIND_OPTION_CLAUSES"
title="Permalink to this definition">¶</a></dt>
+<dd></dd></dl>
+
+<dl class="attribute">
+<dt id="roster_config_manager.__init__.ConfigLib.CHECKZONE_ARGS_DICT">
+<tt class="descname">CHECKZONE_ARGS_DICT</tt><em class="property"> =
{'check-integrity': {'flag': '-i', 'arg': 'full'}, 'check-srv-cname':
{'flag': '-S', 'arg': 'warn'}, 'check-wildcard':
{'flag': '-W', 'arg': 'warn'}, 'check-names':
{'flag': '-k', 'arg': 'fail'}, 'check-mx':
{'flag': '-m', 'arg': 'warn'}, 'check-dup-records':
{'flag': '-r', 'arg': 'warn'}, 'check-mx-cname':
{'flag': '-M', 'arg': 'warn'}}</em><a class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.CHECKZONE_ARGS_DICT"
title="Permalink to this definition">¶</a></dt>
+<dd></dd></dl>
+
+<dl class="attribute">
+<dt id="roster_config_manager.__init__.ConfigLib.COMMANDS_CONVERT_DICT">
+<tt class="descname">COMMANDS_CONVERT_DICT</tt><em class="property"> =
{'check-integrity': {'yes': 'full', 'no': 'none'}, 'check-srv-cname':
{'fail': 'fail', 'warn': 'warn', 'ignore': 'ignore'}, 'check-wildcard':
{'yes': 'warn', 'no': 'ignore'}, 'check-names':
{'default': 'fail', 'flag': '-k'}, 'check-mx':
{'fail': 'fail', 'warn': 'warn', 'ignore': 'ignore'}, 'check-dup-records':
{'fail': 'fail', 'warn': 'warn', 'ignore': 'ignore'}, 'check-mx-cname':
{'fail': 'fail', 'warn': 'warn', 'ignore': 'ignore'}}</em><a
class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.COMMANDS_CONVERT_DICT"
title="Permalink to this definition">¶</a></dt>
+<dd></dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.ConfigLib.CheckDnsServer">
+<tt class="descname">CheckDnsServer</tt><big>(</big><em>dns_server</em>,
<em>tools_check_list</em><big>)</big><a class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.CheckDnsServer"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Checks a DNS server for connection, that necessary directories are
+created, that BIND is installed, and availability of tools.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>dns_server: name of DNS server to check
+tools_check_list: list of tools to check</dd>
+<dt>Raises:</dt>
+<dd><p class="first">ExporterFileError: Can not list files in /dir.
+ServerCheckError: DNS server 1.2.3.4 does not exist.
+ServerCheckError: DNS server metadata file incorrectly written or does</p>
+<blockquote>
+<div>not exist.</div></blockquote>
+<p>ServerCheckError: Can not connect to 1.2.3.4 via SSH.
+ServerCheckError: Unable to run ‘named’ on 1.2.3.4. Is BIND
installed</p>
+<blockquote>
+<div>on the remote server?</div></blockquote>
+<dl class="last docutils">
+<dt>ServerCheckError: The remote test directory /etc/bind/test does not
exist</dt>
+<dd>or the user someone does not have permission.</dd>
+<dt>ServerCheckError: The remote BIND directory /etc/bind does not exist
or</dt>
+<dd>the user someone does not have permission.</dd>
+</dl>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.ConfigLib.FindAllDnsServers">
+<tt class="descname">FindAllDnsServers</tt><big>(</big><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.FindAllDnsServers"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Finds and returns the names of all the DNS servers that we are
exporting.</p>
+<p>This must be run after the bind trees are untarred to the
+root_config_dir.</p>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.ConfigLib.FindDnsTreeFilename">
+<tt
class="descname">FindDnsTreeFilename</tt><big>(</big><em>audit_log_id</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.FindDnsTreeFilename"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Finds the filename of the Dns Tree from the audit log id given.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>audit_log_id: id of the requested audit log.</dd>
+<dt>Raises:</dt>
+<dd>ExporterAuditIdError: No audit log id supplied.
+ExporterFileError: Can not list files in /dir.
+ExporterFileError: DNS Tree file /dir/filename is not named correctly.</dd>
+<dt>Outputs:</dt>
+<dd>string: filename of DNS Tree file</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt
id="roster_config_manager.__init__.ConfigLib.FindNewestDnsTreeFilename">
+<tt
class="descname">FindNewestDnsTreeFilename</tt><big>(</big><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.FindNewestDnsTreeFilename"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Finds the filename of the newest Dns Tree file in the backup
directory.</p>
+<dl class="docutils">
+<dt>Raises:</dt>
+<dd><p class="first">ExporterListFileError: Can not list files in /dir.
+ExporterNoFileError: Backup directory /dir does not contain any files</p>
+<blockquote>
+<div>or directories.</div></blockquote>
+<p class="last">ExporterFileNameError: DNS Tree file /dir/filename is not
named correctly.
+ExporterNoFileError: Could not find a DNS Tree file in /dir.</p>
+</dd>
+<dt>Outputs:</dt>
+<dd>tuple: id of audit log, name of Dns Tree file for audit log id</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt
id="roster_config_manager.__init__.ConfigLib.GenerateAdditionalNamedCheckzoneArgs">
+<tt
class="descname">GenerateAdditionalNamedCheckzoneArgs</tt><big>(</big><em>bind_options_dict</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.GenerateAdditionalNamedCheckzoneArgs"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Generates additional named-checkzone command line flags and
arguments based
+on the BIND options supplied in bind_options_dict.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>bind_options_dict: dict of BIND options parsed from named.conf</dd>
+<dt>Outputs:</dt>
+<dd>args: list of flags and their args.</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.ConfigLib.GetDnsServerInfo">
+<tt
class="descname">GetDnsServerInfo</tt><big>(</big><em>dns_server</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.GetDnsServerInfo"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Gets the information about a DNS server from the
dns_server.info
file</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>dns_server: name of DNS server</dd>
+<dt>Raises:</dt>
+<dd><dl class="first docutils">
+<dt>ExporterNoFileError: DNS tree does not exist or has not been </dt>
+<dd>exported yet.</dd>
+</dl>
+<p class="last">ServerCheckError: DNS server server_name does not exist.
+ServerCheckError: DNS server metadata file does not exist.
+ServerCheckError: DNS server metadata file incorrectly written.</p>
+</dd>
+<dt>Outputs:</dt>
+<dd><dl class="first last docutils">
+<dt>dict: {‘server_info’: {</dt>
+<dd><blockquote class="first">
+<div>‘server_name’: ‘university.lcl’,
+‘server_user’: ‘user’,
+‘bind_dir’: ‘/etc/bind/’,
+‘test_dir’: ‘/etc/bind/test/’,
+‘bind_version’: ‘UNKNOWN’},</div></blockquote>
+<dl class="last docutils">
+<dt>‘tools’: {</dt>
+<dd>‘tar’: ‘True’}}</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.ConfigLib.GetNamedZoneToolArgs">
+<tt
class="descname">GetNamedZoneToolArgs</tt><big>(</big><em>dns_server</em>,
<em>view</em>, <em>zone_file_name</em><big>)</big><a class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.GetNamedZoneToolArgs"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Generates the arg flags for named-checkzone and named-compilezone
+for a specific zone-view-server combination.</p>
+<blockquote>
+<div><dl class="docutils">
+<dt>Inputs:</dt>
+<dd>dns_server: name of a DNS server
+view: name of a view
+zone_file_name: the file name of a zone</dd>
+<dt>Outputs:</dt>
+<dd><dl class="first last docutils">
+<dt>string: string of the command flags and their values for
named-checkzone</dt>
+<dd>and named-compilezone.</dd>
+</dl>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.ConfigLib.GetZoneList">
+<tt
class="descname">GetZoneList</tt><big>(</big><em>dns_server</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.GetZoneList"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Gets all of the zones from a BIND tree for a DNS server.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>dns_server: name of a DNS server</dd>
+<dt>Outputs:</dt>
+<dd><dl class="first last docutils">
+<dt>dict: {‘view1’: {‘zone1.lcl’:
‘zone.db’, ‘zone2’.lcl: ‘zone.db’},</dt>
+<dd>‘view2’: {‘zone3.lcl’: ‘zone.db’,
‘zone4.lcl’: ‘zone.db’}}</dd>
+</dl>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.ConfigLib.MergeOptionsDicts">
+<tt
class="descname">MergeOptionsDicts</tt><big>(</big><em>global_options_dict</em>,
<em>view_dict</em>, <em>zone_dict</em><big>)</big><a class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.MergeOptionsDicts"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Merges the options of 3 dictionaries, according to precendence.
+zone_dict is the most importantce, while global_options_dict has the
“least”
+importantance.</p>
+<blockquote>
+<div><dl class="docutils">
+<dt>Inputs:</dt>
+<dd>global_options_dict: dict of the options defined globally in named.conf
+view_dict: dict of the options defined in a single view of named.conf
+zone_dict: dict of the options defined in a single zone of named.conf</dd>
+<dt>Outputs:</dt>
+<dd>single_options_dict: dict of the merged options</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.ConfigLib.TarDnsBindFiles">
+<tt
class="descname">TarDnsBindFiles</tt><big>(</big><em>dns_server</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.TarDnsBindFiles"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Tars the BIND tree for a DNS server.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>dns_server: name of dns_server</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.ConfigLib.TarDnsTree">
+<tt
class="descname">TarDnsTree</tt><big>(</big><em>audit_log_id</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.TarDnsTree"
title="Permalink to this definition">¶</a></dt>
+<dd><dl class="docutils">
+<dt>Compresses the uncompressed Roster Tree in the root configuration</dt>
+<dd>directory to the compressed Roster Tree in the Bind Directory.</dd>
+<dt>Inputs:</dt>
+<dd>audit_log_id: id of the audit log to a backup tree</dd>
+<dt>Raises:</dt>
+<dd>ExporterAuditIdError No audit log id supplied.
+ExporterFileError Can not list files in /dir</dd>
+</dl>
+</dd></dl>
+
+<dl class="attribute">
+<dt id="roster_config_manager.__init__.ConfigLib.ToolList">
+<tt class="descname">ToolList</tt><em class="property"> =
['named-checkzone', 'named-compilezone', 'named-checkconf', 'tar']</em><a
class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.ToolList" title="Permalink
to this definition">¶</a></dt>
+<dd></dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.ConfigLib.UnTarDnsTree">
+<tt
class="descname">UnTarDnsTree</tt><big>(</big><em>audit_log_id=None</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.UnTarDnsTree"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Uncompresses the compressed Dns Tree to the
+root configuration directory.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>audit_log_id: id of the audit log of a compressed dns tree</dd>
+<dt>Outputs:</dt>
+<dd>audit_log_id: int - the same as the input, unless the input is None.
+In which case, the most recent audit log will be returned.</dd>
+<dt>Raises:</dt>
+<dd>ExporterFileError Compressed files will not be extracted to
/root/config.</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.ConfigLib.WriteDnsServerInfo">
+<tt
class="descname">WriteDnsServerInfo</tt><big>(</big><em>server_info_dict</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.ConfigLib.WriteDnsServerInfo"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Writes the information about a DNS server to the
dns_server.info
file.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd><dl class="first last docutils">
+<dt>server_info_dict: dict of the DNS server’s information</dt>
+<dd><dl class="first last docutils">
+<dt>Example:</dt>
+<dd><dl class="first last docutils">
+<dt>{‘server_info’: {</dt>
+<dd><blockquote class="first">
+<div>‘server_name’: ‘university.lcl’,
+‘server_user’: ‘user’,
+‘bind_dir’: ‘/etc/bind/’,
+‘test_dir’: ‘/etc/bind/test/’,
+‘bind_version’: ‘UNKNOWN’},</div></blockquote>
+<dl class="last docutils">
+<dt>‘tools’: {</dt>
+<dd>‘tar’: ‘True’}}</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+<dt>Raises:</dt>
+<dd><dl class="first docutils">
+<dt>ExporterNoFileError: DNS tree does not exist or has not been</dt>
+<dd>exported yet.</dd>
+</dl>
+<p class="last">ServerCheckError: DNS server server_name does not exist.
+ServerCheckError: Invalid DNS server information supplied.</p>
+</dd>
+</dl>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="class">
+<dt id="roster_config_manager.__init__.BindTreeExport">
+<em class="property">class </em><tt
class="descclassname">roster_config_manager.__init__.</tt><tt
class="descname">BindTreeExport</tt><big>(</big><em>config_file_name</em><big>)</big><a
class="headerlink" href="#roster_config_manager.__init__.BindTreeExport"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Bases: <tt class="xref py py-class docutils literal"><span
class="pre">object</span></tt></p>
+<p>This class exports zones</p>
+<dl class="method">
+<dt id="roster_config_manager.__init__.BindTreeExport.AddToTarFile">
+<tt class="descname">AddToTarFile</tt><big>(</big><em>tar_file</em>,
<em>file_name</em>, <em>file_string</em><big>)</big><a class="headerlink"
href="#roster_config_manager.__init__.BindTreeExport.AddToTarFile"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Adds file string to tarfile object</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>tarfile: tarfile object
+file_name: string of filename to add
+file_string: string of file</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.BindTreeExport.CookData">
+<tt class="descname">CookData</tt><big>(</big><em>data</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.BindTreeExport.CookData"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Cooks data for zone exporter</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>data: dictionary of raw data from database</dd>
+<dt>Outputs:</dt>
+<dd><p class="first">dict: dictionary with dns_server_sets and dns_servers
keys, then keyed by
+dns_server_set and dns_server, respectively ex:
+{u’dns_server_sets’:</p>
+<blockquote>
+<div><dl class="docutils">
+<dt>{u’external_dns’:</dt>
+<dd><dl class="first last docutils">
+<dt>{‘dns_servers’: [u’[
ns1.university.edu]’,</dt>
+<dd><blockquote class="first">
+<div>u’[
dns2.university.edu]’,
+u’[
dns3.university.edu]’]}</div></blockquote>
+<dl class="last docutils">
+<dt>‘views’:</dt>
+<dd><dl class="first last docutils">
+<dt>{u’external’:</dt>
+<dd><dl class="first last docutils">
+<dt>{u’
university.edu’:</dt>
+<dd><dl class="first last docutils">
+<dt>{‘records’: [</dt>
+<dd><dl class="first last docutils">
+<dt>{u’serial_number’: 20091227,</dt>
+<dd>u’refresh_seconds’: 5,
+‘target’: u’university.edu.’,
+u’name_server’: u’ns1.university.edu.’,
+u’retry_seconds’: 5, ‘ttl’: 3600,
+u’minimum_seconds’: 5, ‘record_type’:
u’soa’,
+‘view_name’: u’external’,
+‘last_user’: u’sharrell’,
+‘zone_name’: u’
university.edu’,
+u’admin_email’: <a class="reference external"
href="mailto:
u'admin%40university.edu">u'admin<span>@</span>university<span>.</span>edu</a>.’,
+u’expiry_seconds’: 5},</dd>
+<dt>{‘target’: u’computer1’, ‘ttl’:
3600,</dt>
+<dd>‘record_type’: u’a’, ‘view_name’:
u’external’,
+‘last_user’: u’sharrell’,
+‘zone_name’: u’
university.edu’,
+u’assignment_ip’: u‘1.2.3.5’},
+‘zone_origin’: u’example.’,
+‘zone_type’: u’master’}}}},</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</div></blockquote>
+<dl class="last docutils">
+<dt>u’dns_servers’:</dt>
+<dd><dl class="first last docutils">
+<dt>{u’
ns1.university.edu’:</dt>
+<dd><blockquote class="first">
+<div><dl class="docutils">
+<dt>{‘dns_server_remote_bind_directory’:
u’/etc/named/’,</dt>
+<dd>‘dns_server_remote_test_directory’:
u’/etc/named/test/’,
+‘dns_server_ssh_username’: u’dchayes’},</dd>
+</dl>
+</div></blockquote>
+<dl class="last docutils">
+<dt>u’
dns2.university.edu’:</dt>
+<dd><dl class="first last docutils">
+<dt>{‘dns_server_remote_bind_directory’:
u’/etc/bind/’,</dt>
+<dd>‘dns_server_remote_test_directory’:
u’/etc/bind/test/’,
+‘dns_server_ssh_username’: u’ssh_user’}}}</dd>
+</dl>
+</dd>
+<dt>u’
dns3.university.edu’:</dt>
+<dd><dl class="first last docutils">
+<dt>{‘dns_server_remote_bind_directory’:
u’/etc/bind/’,</dt>
+<dd>‘dns_server_remote_test_directory’:
u’/etc/bind/test/’,
+‘dns_server_ssh_username’: u’dchayes’}}}</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.BindTreeExport.CookRawDump">
+<tt
class="descname">CookRawDump</tt><big>(</big><em>raw_dump</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.BindTreeExport.CookRawDump"
title="Permalink to this definition">¶</a></dt>
+<dd><p>This takes raw data from the database and turns it into a
+mysqldump-like output.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd><dl class="first last docutils">
+<dt>raw_dump: list of dictionaries that contain all of the tables</dt>
+<dd>and their associated metadata</dd>
+</dl>
+</dd>
+<dt>Outputs:</dt>
+<dd>list: tuple of list of strings to be concatenated into mysql dump
files</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.BindTreeExport.ExportAllBindTrees">
+<tt
class="descname">ExportAllBindTrees</tt><big>(</big><em>force=False</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.BindTreeExport.ExportAllBindTrees"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Exports bind trees to files</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd><dl class="first last docutils">
+<dt>force: boolean of if the export should continue if no changes are
found</dt>
+<dd>in the database</dd>
+</dl>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.BindTreeExport.GetRawData">
+<tt class="descname">GetRawData</tt><big>(</big><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.BindTreeExport.GetRawData"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Gets raw data from database</p>
+<blockquote>
+<div><blockquote>
+<div><dl class="docutils">
+<dt>Outputs:</dt>
+<dd><dl class="first last docutils">
+<dt>tuple of two dictionaries:</dt>
+<dd><dl class="first last docutils">
+<dt>dictionary of raw data keyed by data name with values of dicts</dt>
+<dd>containing values of that type’s attributes</dd>
+<dt>dictionary of the raw dump keyed by data name with values of</dt>
+<dd>dicts containing the db dump keyed by row, column, and schema</dd>
+</dl>
+</dd>
+<dt>example:</dt>
+<dd><dl class="first last docutils">
+<dt>({‘view_acl_assignments’: ({</dt>
+<dd>‘view_acl_assignments_view_name’: u’external’,
+‘view_acl_assignments_dns_server_set_name’:
u’external_dns’,
+‘view_acl_assignments_acl_name’: u’public’,
+‘view_acl_assignments_acl_range_allowed’: 1})},</dd>
+<dt>{ u’zones’:</dt>
+<dd><dl class="first last docutils">
+<dt>{‘rows’:[{}],</dt>
+<dd><p class="first">‘columns’: [u’zones_id’,
u’zone_name’],
+‘schema’:(</p>
+<blockquote class="last">
+<div>u’CREATE TABLE <cite>zones</cite> (</div></blockquote>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</div></blockquote>
+<dl class="docutils">
+<dt><cite>zones_id</cite> mediumint(8) ‘,</dt>
+<dd>‘unsigned NOT NULL auto_increment,</dd>
+<dt><cite>zone_name</cite> varchar(255) ‘,</dt>
+<dd>‘NOT NULL,</dd>
+</dl>
+<p>PRIMARY KEY (<cite>zones_id</cite>),
+UNIQUE KEY ;</p>
+<blockquote>
+<div>‘<cite>zone_name</cite>
(<cite>zone_name</cite>),</div></blockquote>
+<dl class="docutils">
+<dt>KEY <cite>zone_name_1</cite> ‘</dt>
+<dd>‘(<cite>zone_name</cite>)</dd>
+</dl>
+</div></blockquote>
+<dl class="docutils">
+<dt>) ENGINE=InnoDB AUTO_INCREMENT=9 DEFAULT ‘,</dt>
+<dd>‘CHARSET=utf8’)}}),</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.BindTreeExport.ListACLNamesByView">
+<tt class="descname">ListACLNamesByView</tt><big>(</big><em>data</em>,
<em>view</em><big>)</big><a class="headerlink"
href="#roster_config_manager.__init__.BindTreeExport.ListACLNamesByView"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Lists acl names</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>data: data from GetRawData
+view: string of view name</dd>
+<dt>Outputs:</dt>
+<dd><dl class="first last docutils">
+<dt>list: list of acl names ex:</dt>
+<dd>[‘private’, ‘public’]</dd>
+</dl>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt
id="roster_config_manager.__init__.BindTreeExport.ListLatestNamedConfGlobalOptions">
+<tt
class="descname">ListLatestNamedConfGlobalOptions</tt><big>(</big><em>data</em>,
<em>dns_server_set</em>, <em>binary=False</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.BindTreeExport.ListLatestNamedConfGlobalOptions"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Lists latest named.conf global options</p>
+<p>This function is duplicated in
roster-core/roster_core/core_helpers.py</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>data: data from GetRawData
+dns_server_set: string of dns server set name
+binary: True if named.conf file format is binary, false otherwise</dd>
+<dt>Outputs:</dt>
+<dd>string: string of latest named.conf global options</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt
id="roster_config_manager.__init__.BindTreeExport.ListRecordArgumentDefinitions">
+<tt
class="descname">ListRecordArgumentDefinitions</tt><big>(</big><em>record_arguments</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.BindTreeExport.ListRecordArgumentDefinitions"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Lists record argument definitions given table from database</p>
+<p>This function is duplicated in roster-core/roster_core/core.py</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>record_arguments: record arguments from database</dd>
+<dt>Outputs:</dt>
+<dd><dl class="first last docutils">
+<dt>dictionary keyed by record type with values of lists</dt>
+<dd><p class="first">of lists of record arguments sorted by argument order.
+example: {‘mx’: [{‘argument_name’:
u’priority’,</p>
+<blockquote class="last">
+<div><blockquote>
+<div>‘record_arguments_type’: u’mx’,
+‘argument_data_type’: u’UnsignedInt’,
+‘argument_order’: 0},</div></blockquote>
+<dl class="docutils">
+<dt>{‘argument_name’: u’mail_server’,</dt>
+<dd>‘record_arguments_type’: u’mx’,
+‘argument_data_type’: u’Hostname’,
+‘argument_order’: 1}]}</dd>
+</dl>
+</div></blockquote>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.BindTreeExport.MakeNamedConf">
+<tt class="descname">MakeNamedConf</tt><big>(</big><em>data</em>,
<em>cooked_data</em>, <em>dns_server_set</em>, <em>extension</em>,
<em>remote_bind_dir</em>, <em>binary=False</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.BindTreeExport.MakeNamedConf"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Makes named.conf file strings</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>data: data from GetRawData
+cooked_data: data from cooked_data
+dns_server_set: string of dns_server_set
+extension: bind extension, e.g., .db, .aa (binary), etc
+remote_bind_dir: string of remote server bind dir
+binary: True if named.conf file format is binary, false otherwise</dd>
+<dt>Outputs:</dt>
+<dd>string: string of named.conf file</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt
id="roster_config_manager.__init__.BindTreeExport.NamedHeaderChangeDirectory">
+<tt
class="descname">NamedHeaderChangeDirectory</tt><big>(</big><em>named_conf_header</em>,
<em>new_directory</em><big>)</big><a class="headerlink"
href="#roster_config_manager.__init__.BindTreeExport.NamedHeaderChangeDirectory"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Adds/Changes directory in named.conf header</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>named_conf_header: string of namedconf header
+new_directory: {}</dd>
+<dt>Outputs:</dt>
+<dd>string: string of namedconf header</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.__init__.BindTreeExport.SortRecords">
+<tt
class="descname">SortRecords</tt><big>(</big><em>records</em><big>)</big><a
class="headerlink"
href="#roster_config_manager.__init__.BindTreeExport.SortRecords"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Sorts records for zone exporter</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>records: list of records</dd>
+<dt>Outputs:</dt>
+<dd><p class="first">dict: dictionary keyed by tuple (zone, view_dep)
+ex:
+{(u’
university.edu’, u’internal_dep’):</p>
+<blockquote class="last">
+<div><dl class="docutils">
+<dt>{11: {‘target’: u’computer4’,
‘ttl’: 3600, ‘record_type’: u’a’,</dt>
+<dd><blockquote class="first">
+<div>‘view_name’: u’internal’,
‘last_user’: u’sharrell’,
+‘zone_name’: u’
university.edu’,
+u’assignment_ip’:
u‘192.168.1.4’},</div></blockquote>
+<dl class="last docutils">
+<dt>12: {u’serial_number’: 20091225,
u’refresh_seconds’: 5,</dt>
+<dd>‘target’: u’university.edu.’,
+u’name_server’: u’ns1.university.edu.’,
u’retry_seconds’: 5,
+‘ttl’: 3600, u’minimum_seconds’: 5,
‘record_type’: u’soa’,
+‘view_name’: u’internal’, ‘last_user’:
u’sharrell’,
+‘zone_name’: u’
university.edu’,
+u’admin_email’: <a class="reference external"
href="mailto:
u'admin%40university.edu">u'admin<span>@</span>university<span>.</span>edu</a>.’,
+u’expiry_seconds’: 5}}}</dd>
+</dl>
+</dd>
+</dl>
+</div></blockquote>
+</dd>
+</dl>
+</dd></dl>
+
+</dd></dl>
+
+</div>
+<div class="section" id="module-roster_config_manager.config_lib">
+<span id="config-lib-module"></span><h2><tt class="xref py py-mod docutils
literal"><span class="pre">config_lib</span></tt> Module<a
class="headerlink" href="#module-roster_config_manager.config_lib"
title="Permalink to this headline">¶</a></h2>
+<p>This module conains all of the logic to check dns servers.</p>
+<dl class="class">
+<dt id="roster_config_manager.config_lib.ConfigLib">
+<em class="property">class </em><tt
class="descclassname">roster_config_manager.config_lib.</tt><tt
class="descname">ConfigLib</tt><big>(</big><em>config_file</em><big>)</big><a
class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ConfigLib"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib" title="Permalink to this
definition">¶</a></dt>
+<dd><p>Bases: <tt class="xref py py-class docutils literal"><span
class="pre">object</span></tt></p>
+<p>This class checks a DNS server for the functionality required to push
+zone files to it</p>
+<dl class="attribute">
+<dt id="roster_config_manager.config_lib.ConfigLib.BIND_OPTION_CLAUSES">
+<tt class="descname">BIND_OPTION_CLAUSES</tt><em class="property"> =
{'check-wildcard': 'yes', 'check-names': 'warn', 'check-integrity': 'yes', 'check-mx': 'warn', 'check-dup-records': 'warn', 'check-siblings': 'yes', 'check-mx-cname': 'warn', 'check-srv-cname': 'warn'}</em><a
class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.BIND_OPTION_CLAUSES"
title="Permalink to this definition">¶</a></dt>
+<dd></dd></dl>
+
+<dl class="attribute">
+<dt id="roster_config_manager.config_lib.ConfigLib.CHECKZONE_ARGS_DICT">
+<tt class="descname">CHECKZONE_ARGS_DICT</tt><em class="property"> =
{'check-integrity': {'flag': '-i', 'arg': 'full'}, 'check-srv-cname':
{'flag': '-S', 'arg': 'warn'}, 'check-wildcard':
{'flag': '-W', 'arg': 'warn'}, 'check-names':
{'flag': '-k', 'arg': 'fail'}, 'check-mx':
{'flag': '-m', 'arg': 'warn'}, 'check-dup-records':
{'flag': '-r', 'arg': 'warn'}, 'check-mx-cname':
{'flag': '-M', 'arg': 'warn'}}</em><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.CHECKZONE_ARGS_DICT"
title="Permalink to this definition">¶</a></dt>
+<dd></dd></dl>
+
+<dl class="attribute">
+<dt id="roster_config_manager.config_lib.ConfigLib.COMMANDS_CONVERT_DICT">
+<tt class="descname">COMMANDS_CONVERT_DICT</tt><em class="property"> =
{'check-integrity': {'yes': 'full', 'no': 'none'}, 'check-srv-cname':
{'fail': 'fail', 'warn': 'warn', 'ignore': 'ignore'}, 'check-wildcard':
{'yes': 'warn', 'no': 'ignore'}, 'check-names':
{'default': 'fail', 'flag': '-k'}, 'check-mx':
{'fail': 'fail', 'warn': 'warn', 'ignore': 'ignore'}, 'check-dup-records':
{'fail': 'fail', 'warn': 'warn', 'ignore': 'ignore'}, 'check-mx-cname':
{'fail': 'fail', 'warn': 'warn', 'ignore': 'ignore'}}</em><a
class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.COMMANDS_CONVERT_DICT"
title="Permalink to this definition">¶</a></dt>
+<dd></dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.config_lib.ConfigLib.CheckDnsServer">
+<tt class="descname">CheckDnsServer</tt><big>(</big><em>dns_server</em>,
<em>tools_check_list</em><big>)</big><a class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ConfigLib.CheckDnsServer"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.CheckDnsServer"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Checks a DNS server for connection, that necessary directories are
+created, that BIND is installed, and availability of tools.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>dns_server: name of DNS server to check
+tools_check_list: list of tools to check</dd>
+<dt>Raises:</dt>
+<dd><p class="first">ExporterFileError: Can not list files in /dir.
+ServerCheckError: DNS server 1.2.3.4 does not exist.
+ServerCheckError: DNS server metadata file incorrectly written or does</p>
+<blockquote>
+<div>not exist.</div></blockquote>
+<p>ServerCheckError: Can not connect to 1.2.3.4 via SSH.
+ServerCheckError: Unable to run ‘named’ on 1.2.3.4. Is BIND
installed</p>
+<blockquote>
+<div>on the remote server?</div></blockquote>
+<dl class="last docutils">
+<dt>ServerCheckError: The remote test directory /etc/bind/test does not
exist</dt>
+<dd>or the user someone does not have permission.</dd>
+<dt>ServerCheckError: The remote BIND directory /etc/bind does not exist
or</dt>
+<dd>the user someone does not have permission.</dd>
+</dl>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.config_lib.ConfigLib.FindAllDnsServers">
+<tt class="descname">FindAllDnsServers</tt><big>(</big><big>)</big><a
class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ConfigLib.FindAllDnsServers"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.FindAllDnsServers"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Finds and returns the names of all the DNS servers that we are
exporting.</p>
+<p>This must be run after the bind trees are untarred to the
+root_config_dir.</p>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.config_lib.ConfigLib.FindDnsTreeFilename">
+<tt
class="descname">FindDnsTreeFilename</tt><big>(</big><em>audit_log_id</em><big>)</big><a
class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ConfigLib.FindDnsTreeFilename"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.FindDnsTreeFilename"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Finds the filename of the Dns Tree from the audit log id given.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>audit_log_id: id of the requested audit log.</dd>
+<dt>Raises:</dt>
+<dd>ExporterAuditIdError: No audit log id supplied.
+ExporterFileError: Can not list files in /dir.
+ExporterFileError: DNS Tree file /dir/filename is not named correctly.</dd>
+<dt>Outputs:</dt>
+<dd>string: filename of DNS Tree file</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt
id="roster_config_manager.config_lib.ConfigLib.FindNewestDnsTreeFilename">
+<tt
class="descname">FindNewestDnsTreeFilename</tt><big>(</big><big>)</big><a
class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ConfigLib.FindNewestDnsTreeFilename"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.FindNewestDnsTreeFilename"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Finds the filename of the newest Dns Tree file in the backup
directory.</p>
+<dl class="docutils">
+<dt>Raises:</dt>
+<dd><p class="first">ExporterListFileError: Can not list files in /dir.
+ExporterNoFileError: Backup directory /dir does not contain any files</p>
+<blockquote>
+<div>or directories.</div></blockquote>
+<p class="last">ExporterFileNameError: DNS Tree file /dir/filename is not
named correctly.
+ExporterNoFileError: Could not find a DNS Tree file in /dir.</p>
+</dd>
+<dt>Outputs:</dt>
+<dd>tuple: id of audit log, name of Dns Tree file for audit log id</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt
id="roster_config_manager.config_lib.ConfigLib.GenerateAdditionalNamedCheckzoneArgs">
+<tt
class="descname">GenerateAdditionalNamedCheckzoneArgs</tt><big>(</big><em>bind_options_dict</em><big>)</big><a
class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ConfigLib.GenerateAdditionalNamedCheckzoneArgs"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.GenerateAdditionalNamedCheckzoneArgs"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Generates additional named-checkzone command line flags and
arguments based
+on the BIND options supplied in bind_options_dict.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>bind_options_dict: dict of BIND options parsed from named.conf</dd>
+<dt>Outputs:</dt>
+<dd>args: list of flags and their args.</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.config_lib.ConfigLib.GetDnsServerInfo">
+<tt
class="descname">GetDnsServerInfo</tt><big>(</big><em>dns_server</em><big>)</big><a
class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ConfigLib.GetDnsServerInfo"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.GetDnsServerInfo"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Gets the information about a DNS server from the
dns_server.info
file</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>dns_server: name of DNS server</dd>
+<dt>Raises:</dt>
+<dd><dl class="first docutils">
+<dt>ExporterNoFileError: DNS tree does not exist or has not been </dt>
+<dd>exported yet.</dd>
+</dl>
+<p class="last">ServerCheckError: DNS server server_name does not exist.
+ServerCheckError: DNS server metadata file does not exist.
+ServerCheckError: DNS server metadata file incorrectly written.</p>
+</dd>
+<dt>Outputs:</dt>
+<dd><dl class="first last docutils">
+<dt>dict: {‘server_info’: {</dt>
+<dd><blockquote class="first">
+<div>‘server_name’: ‘university.lcl’,
+‘server_user’: ‘user’,
+‘bind_dir’: ‘/etc/bind/’,
+‘test_dir’: ‘/etc/bind/test/’,
+‘bind_version’: ‘UNKNOWN’},</div></blockquote>
+<dl class="last docutils">
+<dt>‘tools’: {</dt>
+<dd>‘tar’: ‘True’}}</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.config_lib.ConfigLib.GetNamedZoneToolArgs">
+<tt
class="descname">GetNamedZoneToolArgs</tt><big>(</big><em>dns_server</em>,
<em>view</em>, <em>zone_file_name</em><big>)</big><a class="reference
internal"
href="_modules/roster_config_manager/config_lib.html#ConfigLib.GetNamedZoneToolArgs"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.GetNamedZoneToolArgs"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Generates the arg flags for named-checkzone and named-compilezone
+for a specific zone-view-server combination.</p>
+<blockquote>
+<div><dl class="docutils">
+<dt>Inputs:</dt>
+<dd>dns_server: name of a DNS server
+view: name of a view
+zone_file_name: the file name of a zone</dd>
+<dt>Outputs:</dt>
+<dd><dl class="first last docutils">
+<dt>string: string of the command flags and their values for
named-checkzone</dt>
+<dd>and named-compilezone.</dd>
+</dl>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.config_lib.ConfigLib.GetZoneList">
+<tt
class="descname">GetZoneList</tt><big>(</big><em>dns_server</em><big>)</big><a
class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ConfigLib.GetZoneList"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.GetZoneList"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Gets all of the zones from a BIND tree for a DNS server.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>dns_server: name of a DNS server</dd>
+<dt>Outputs:</dt>
+<dd><dl class="first last docutils">
+<dt>dict: {‘view1’: {‘zone1.lcl’:
‘zone.db’, ‘zone2’.lcl: ‘zone.db’},</dt>
+<dd>‘view2’: {‘zone3.lcl’: ‘zone.db’,
‘zone4.lcl’: ‘zone.db’}}</dd>
+</dl>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.config_lib.ConfigLib.MergeOptionsDicts">
+<tt
class="descname">MergeOptionsDicts</tt><big>(</big><em>global_options_dict</em>,
<em>view_dict</em>, <em>zone_dict</em><big>)</big><a class="reference
internal"
href="_modules/roster_config_manager/config_lib.html#ConfigLib.MergeOptionsDicts"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.MergeOptionsDicts"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Merges the options of 3 dictionaries, according to precendence.
+zone_dict is the most importantce, while global_options_dict has the
“least”
+importantance.</p>
+<blockquote>
+<div><dl class="docutils">
+<dt>Inputs:</dt>
+<dd>global_options_dict: dict of the options defined globally in named.conf
+view_dict: dict of the options defined in a single view of named.conf
+zone_dict: dict of the options defined in a single zone of named.conf</dd>
+<dt>Outputs:</dt>
+<dd>single_options_dict: dict of the merged options</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.config_lib.ConfigLib.TarDnsBindFiles">
+<tt
class="descname">TarDnsBindFiles</tt><big>(</big><em>dns_server</em><big>)</big><a
class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ConfigLib.TarDnsBindFiles"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.TarDnsBindFiles"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Tars the BIND tree for a DNS server.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>dns_server: name of dns_server</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.config_lib.ConfigLib.TarDnsTree">
+<tt
class="descname">TarDnsTree</tt><big>(</big><em>audit_log_id</em><big>)</big><a
class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ConfigLib.TarDnsTree"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.TarDnsTree"
title="Permalink to this definition">¶</a></dt>
+<dd><dl class="docutils">
+<dt>Compresses the uncompressed Roster Tree in the root configuration</dt>
+<dd>directory to the compressed Roster Tree in the Bind Directory.</dd>
+<dt>Inputs:</dt>
+<dd>audit_log_id: id of the audit log to a backup tree</dd>
+<dt>Raises:</dt>
+<dd>ExporterAuditIdError No audit log id supplied.
+ExporterFileError Can not list files in /dir</dd>
+</dl>
+</dd></dl>
+
+<dl class="attribute">
+<dt id="roster_config_manager.config_lib.ConfigLib.ToolList">
+<tt class="descname">ToolList</tt><em class="property"> =
['named-checkzone', 'named-compilezone', 'named-checkconf', 'tar']</em><a
class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.ToolList"
title="Permalink to this definition">¶</a></dt>
+<dd></dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.config_lib.ConfigLib.UnTarDnsTree">
+<tt
class="descname">UnTarDnsTree</tt><big>(</big><em>audit_log_id=None</em><big>)</big><a
class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ConfigLib.UnTarDnsTree"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.UnTarDnsTree"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Uncompresses the compressed Dns Tree to the
+root configuration directory.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd>audit_log_id: id of the audit log of a compressed dns tree</dd>
+<dt>Outputs:</dt>
+<dd>audit_log_id: int - the same as the input, unless the input is None.
+In which case, the most recent audit log will be returned.</dd>
+<dt>Raises:</dt>
+<dd>ExporterFileError Compressed files will not be extracted to
/root/config.</dd>
+</dl>
+</dd></dl>
+
+<dl class="method">
+<dt id="roster_config_manager.config_lib.ConfigLib.WriteDnsServerInfo">
+<tt
class="descname">WriteDnsServerInfo</tt><big>(</big><em>server_info_dict</em><big>)</big><a
class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ConfigLib.WriteDnsServerInfo"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigLib.WriteDnsServerInfo"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Writes the information about a DNS server to the
dns_server.info
file.</p>
+<dl class="docutils">
+<dt>Inputs:</dt>
+<dd><dl class="first last docutils">
+<dt>server_info_dict: dict of the DNS server’s information</dt>
+<dd><dl class="first last docutils">
+<dt>Example:</dt>
+<dd><dl class="first last docutils">
+<dt>{‘server_info’: {</dt>
+<dd><blockquote class="first">
+<div>‘server_name’: ‘university.lcl’,
+‘server_user’: ‘user’,
+‘bind_dir’: ‘/etc/bind/’,
+‘test_dir’: ‘/etc/bind/test/’,
+‘bind_version’: ‘UNKNOWN’},</div></blockquote>
+<dl class="last docutils">
+<dt>‘tools’: {</dt>
+<dd>‘tar’: ‘True’}}</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+<dt>Raises:</dt>
+<dd><dl class="first docutils">
+<dt>ExporterNoFileError: DNS tree does not exist or has not been</dt>
+<dd>exported yet.</dd>
+</dl>
+<p class="last">ServerCheckError: DNS server server_name does not exist.
+ServerCheckError: Invalid DNS server information supplied.</p>
+</dd>
+</dl>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="exception">
+<dt id="roster_config_manager.config_lib.ConfigManagerError">
+<em class="property">exception </em><tt
class="descclassname">roster_config_manager.config_lib.</tt><tt
class="descname">ConfigManagerError</tt><a class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ConfigManagerError"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ConfigManagerError"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Bases: <tt class="xref py py-class docutils literal"><span
class="pre">roster_core.errors.CoreError</span></tt></p>
+</dd></dl>
+
+<dl class="exception">
+<dt id="roster_config_manager.config_lib.ExporterAuditIdError">
+<em class="property">exception </em><tt
class="descclassname">roster_config_manager.config_lib.</tt><tt
class="descname">ExporterAuditIdError</tt><a class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ExporterAuditIdError"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ExporterAuditIdError"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Bases: <a class="reference internal"
href="#roster_config_manager.config_lib.ConfigManagerError"
title="roster_config_manager.config_lib.ConfigManagerError"><tt class="xref
py py-class docutils literal"><span
class="pre">roster_config_manager.config_lib.ConfigManagerError</span></tt></a>,
<tt class="xref py py-class docutils literal"><span
class="pre">roster_core.errors.UserError</span></tt></p>
+</dd></dl>
+
+<dl class="exception">
+<dt id="roster_config_manager.config_lib.ExporterFileError">
+<em class="property">exception </em><tt
class="descclassname">roster_config_manager.config_lib.</tt><tt
class="descname">ExporterFileError</tt><a class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ExporterFileError"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ExporterFileError" title="Permalink
to this definition">¶</a></dt>
+<dd><p>Bases: <a class="reference internal"
href="#roster_config_manager.config_lib.ConfigManagerError"
title="roster_config_manager.config_lib.ConfigManagerError"><tt class="xref
py py-class docutils literal"><span
class="pre">roster_config_manager.config_lib.ConfigManagerError</span></tt></a>,
<tt class="xref py py-class docutils literal"><span
class="pre">roster_core.errors.UserError</span></tt></p>
+</dd></dl>
+
+<dl class="exception">
+<dt id="roster_config_manager.config_lib.ExporterFileNameError">
+<em class="property">exception </em><tt
class="descclassname">roster_config_manager.config_lib.</tt><tt
class="descname">ExporterFileNameError</tt><a class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ExporterFileNameError"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ExporterFileNameError"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Bases: <a class="reference internal"
href="#roster_config_manager.config_lib.ExporterFileError"
title="roster_config_manager.config_lib.ExporterFileError"><tt class="xref
py py-class docutils literal"><span
class="pre">roster_config_manager.config_lib.ExporterFileError</span></tt></a></p>
+</dd></dl>
+
+<dl class="exception">
+<dt id="roster_config_manager.config_lib.ExporterListFileError">
+<em class="property">exception </em><tt
class="descclassname">roster_config_manager.config_lib.</tt><tt
class="descname">ExporterListFileError</tt><a class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ExporterListFileError"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ExporterListFileError"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Bases: <a class="reference internal"
href="#roster_config_manager.config_lib.ExporterFileError"
title="roster_config_manager.config_lib.ExporterFileError"><tt class="xref
py py-class docutils literal"><span
class="pre">roster_config_manager.config_lib.ExporterFileError</span></tt></a></p>
+</dd></dl>
+
+<dl class="exception">
+<dt id="roster_config_manager.config_lib.ExporterNoFileError">
+<em class="property">exception </em><tt
class="descclassname">roster_config_manager.config_lib.</tt><tt
class="descname">ExporterNoFileError</tt><a class="reference internal"
href="_modules/roster_config_manager/config_lib.html#ExporterNoFileError"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.ExporterNoFileError"
title="Permalink to this definition">¶</a></dt>
+<dd><p>Bases: <a class="reference internal"
href="#roster_config_manager.config_lib.ConfigManagerError"
title="roster_config_manager.config_lib.ConfigManagerError"><tt class="xref
py py-class docutils literal"><span
class="pre">roster_config_manager.config_lib.ConfigManagerError</span></tt></a>,
<tt class="xref py py-class docutils literal"><span
class="pre">roster_core.errors.UserError</span></tt></p>
+</dd></dl>
+
+<dl class="exception">
+<dt id="roster_config_manager.config_lib.QueryCheckError">
+<em class="property">exception </em><tt
class="descclassname">roster_config_manager.config_lib.</tt><tt
class="descname">QueryCheckError</tt><a class="reference internal"
href="_modules/roster_config_manager/config_lib.html#QueryCheckError"><span
class="viewcode-link">[source]</span></a><a class="headerlink"
href="#roster_config_manager.config_lib.QueryCheckError" title="Permalink
to this definition">¶</a></dt>
+<dd><p>Bases: <a class="reference internal"
href="#roster_config_manager.config_lib.ConfigManagerError"
title="roster_config_manager.config_lib.ConfigManagerError"><tt class="xref
py py-class docutils literal"><span
class="pre">roster_config_manager.config_lib.ConfigManagerError</span></tt></a>,
<tt class="xref py py-class docutils literal"><span
class="pre">roster_core.errors.UserError</span></tt></p>
+</dd></dl>
***The diff for this file has been truncated for email.***
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/search.html Mon Aug
19 17:06:11 2013 UTC
@@ -0,0 +1,105 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="
http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Search — Roster Config Manager v0.18 documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: 'v0.18',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <script type="text/javascript" src="_static/searchtools.js"></script>
+ <link rel="top" title="Roster Config Manager v0.18 documentation"
href="index.html" />
+ <script type="text/javascript">
+ jQuery(function() { Search.loadIndex("searchindex.js"); });
+ </script>
+
+ <script type="text/javascript" id="searchindexloader"></script>
+
+
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <h1 id="search-documentation">Search</h1>
+ <div id="fallback" class="admonition warning">
+ <script type="text/javascript">$('#fallback').hide();</script>
+ <p>
+ Please activate JavaScript to enable the search
+ functionality.
+ </p>
+ </div>
+ <p>
+ From here you can search these documents. Enter your search
+ words into the box below and click "search". Note that the search
+ function will automatically search for all of the words. Pages
+ containing fewer words won't appear in the result list.
+ </p>
+ <form action="" method="get">
+ <input type="text" name="q" value="" />
+ <input type="submit" value="search" />
+ <span id="search-progress" style="padding-left: 10px"></span>
+ </form>
+
+ <div id="search-results">
+
+ </div>
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="index.html">Roster Config Manager v0.18
documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2013, Purdue University.
+ Created using <a href="
http://sphinx-doc.org/">Sphinx</a> 1.2b1.
+ </div>
+ </body>
+</html>
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-config-manager/docs/html/searchindex.js Mon
Aug 19 17:06:11 2013 UTC
@@ -0,0 +1,1 @@
+Search.setIndex({envversion:42,terms:{all:1,getnamedzonetoolarg:1,queri:1,consum:1,dns_server_set:1,edu:1,new_directori:1,formatrecordsforzon:1,ptr:1,row:1,privat:1,zone:1,conain:1,readabl:1,init:1,record_arguments_typ:1,exporterfilenameerror:1,string:1,fals:1,failur:1,cook:1,tree_export:0,servercheckerror:1,tar_fil:1,list:1,server_nam:1,user_nam:1,dir:1,exporterauditiderror:1,second:1,config_lib:0,port:1,index:0,addr:1,abl:1,unsort:1,zone_name_1:1,core_help:1,root_config_dir:1,zone_origin:1,method:1,metadata:1,full:1,gener:1,named_conf_head:1,address:1,path:1,cookdata:1,valu:1,search:0,getzonelist:1,server_info:1,step:1,compilezon:1,chang:1,via:1,modul:0,filenam:1,"boolean":1,mysqldump:1,instal:1,select:1,record_typ:1,from:1,univers:1,two:1,view_acl_assignments_view_nam:1,call:1,type:1,sort:1,raw_dump:1,changesnotfounderror:1,line:1,warn:1,checkdnsserv:1,flag:1,must:1,none:1,restor:1,uniqu:1,bind_options_dict:1,getdnsserverinfo:1,can:1,root:1,mail_serv:1,tar:1,sourc:1,unsign:1,occur:1,usererror:1,server_us:1,charset:1,write:1,recoveri:1,verifi:1,bind_dir:1,zone_importer_lib:0,mergeoptionsdict:1,after:1,data:1,bind:1,inform:1,runauditstep:1,combin:1,assignment_ip:1,order:1,config_fil:1,view1:1,view2:1,zoneerror:1,unexpecteddataerror:1,tardnsbindfil:1,dnsqueri:1,dns_server_ssh_usernam:1,ttl:1,tarfil:1,writednsserverinfo:1,entiti:1,last_us:1,dns_server_remote_test_directori:1,them:1,"return":1,zone_typ:1,exporternofileerror:1,num_records_to_queri:1,name:1,importantc:1,revers:1,innodb:1,found:1,tools_check_list:1,view_nam:1,retry_second:1,continu:1,connect:1,view_acl_assignments_dns_server_set_nam:1,extract:1,roster_cor:1,computer1:1,computer4:1,records_to_queri:1,content:0,exporterlistfileerror:1,file_nam:1,base:1,dictionari:1,put:1,dns3:1,dns2:1,could:1,cookrawdump:1,recov:1,turn:1,cname:1,unabl:1,router:1,first:1,origin:1,rang:1,number:1,dns_port:1,primari:1,prioriti:1,given:1,unknown:1,system:1,least:1,master:1,roster_config_manag:0,schema:1,namedheaderchangedirectori:1,option:1,sortrecord:1,tool:1,unsignedint:1,specifi:1,pars:1,target:1,remot:1,tree:1,addtotarfil:1,were:1,randomli:1,querycheckerror:1,arg:1,argument:1,record_argu:1,packag:0,have:1,name_serv:1,"null":1,engin:1,configmanagererror:1,argument_definit:1,audit_log_id:1,commands_convert_dict:1,take:1,which:1,toollist:1,coreerror:1,singl:1,makerecordsfromzon:1,unless:1,usernam:1,object:1,compress:1,most:1,"class":1,precend:1,correctli:1,request:1,doe:1,wildcard:1,findalldnsserv:1,text:1,runauditrang:1,permiss:1,newest:1,find:1,onli:1,configur:1,arpa:1,should:1,dict:1,getrawdata:1,file_str:1,expiry_second:1,serial_numb:1,get:1,argument_nam:1,good_record:1,ssh:1,requir:1,"public":1,integr:1,contain:1,view:1,set:1,dump:1,generateadditionalnamedcheckzonearg:1,auto_incr:1,fail:1,definit:1,configlib:1,databas:1,user:1,written:1,ssh_user:1,zones_id:1,"import":1,attribut:1,dnsquerycheck:1,accord:1,checkconf:1,kei:1,zone3:1,extens:1,zone1:1,zone4:1,addit:1,view_dict:1,zone2:1,admin:1,mediumint:1,recovererror:1,etc:1,namedconf:1,logic:1,load:1,header:1,suppli:1,respect:1,duplic:1,zone_exporter_lib:0,been:1,argument_data_typ:1,dup:1,checkzon:1,ani:1,catastroph:1,present:1,"case":1,raw:1,defin:1,"while":1,error:1,dns_server_remote_bind_directori:1,pertain:1,bind_option_claus:1,exportallbindtre:1,conf:1,"__init__":1,refresh_second:1,incorrectli:1,make:1,queryfromzonefil:1,view_acl_assignments_acl_range_allow:1,amount:1,same:1,binari:1,minimum_second:1,hostnam:1,utf8:1,someon:1,rais:1,untardnstre:1,extern:1,forward_zone_1:1,recent:1,audit:1,view_acl_assign:1,config_inst:1,test_dir:1,zone_dict:1,exampl:1,command:1,view_dep:1,thi:1,bind_vers:1,sibl:1,latest:1,pushbackup:1,includeerror:1,sharrel:1,mysql:1,single_options_dict:1,yet:1,argument_ord:1,except:1,desktop:1,internal_dep:1,add:1,input:1,listlatestnamedconfglobalopt:1,checkzone_args_dict:1,varchar:1,dns_query_lib:0,format:1,lcl:1,associ:1,like:1,specif:1,integ:1,server:1,bad_record:1,api:1,necessari:1,output:1,page:0,bindtreeexport:1,global:1,intern:1,"export":1,tmp:1,finddnstreefilenam:1,exporterfileerror:1,per:1,remote_bind_dir:1,core:1,zone_file_nam:1,run:1,uncompress:1,host:1,about:1,toplevel:1,column:1,reversezonetocidrblock:1,acl:1,cooked_data:1,srv:1,db_recoveri:0,listrecordargumentdefinit:1,backup:1,block:1,soa:1,server_info_dict:1,within:1,external_dn:1,merg:1,log:1,view_acl_assignments_acl_nam:1,avail:1,dchay:1,"function":1,form:1,forc:1,tupl:1,untar:1,ns2:1,rostercor:1,ns1:1,cidr:1,"true":1,info:1,concaten:1,dns_server:1,"default":1,zone_nam:1,record:1,otherwis:1,makezonestr:1,admin_email:1,audit_log:1,creat:1,"int":1,global_options_dict:1,unsorted_record:1,zoneimport:1,exist:1,file:1,check:1,tardnstre:1,findnewestdnstreefilenam:1,invalid:1,test:1,important:1,sql:1,maintenanceerror:1,listaclnamesbyview:1,directori:1,config_file_nam:1,ignor:1,makenamedconf:1,push:1},objtypes:{"0":"py:module","1":"py:attribute","2":"py:method","3":"py:class","4":"py:exception","5":"py:function"},objnames:{"0":["py","module","Python
module"],"1":["py","attribute","Python
attribute"],"2":["py","method","Python
method"],"3":["py","class","Python
class"],"4":["py","exception","Python
exception"],"5":["py","function","Python
function"]},filenames:["index","roster_config_manager"],titles:["Welcome to
Roster Config Manager’s documentation!","roster_config_manager
Package"],objects:{"roster_config_manager.tree_exporter":{ChangesNotFoundError:[1,4,1,""],Error:[1,4,1,""],MaintenanceError:[1,4,1,""],BindTreeExport:[1,3,1,""]},"roster_config_manager.zone_exporter_lib":{MakeZoneString:[1,5,1,""],ZoneError:[1,4,1,""],FormatRecordsForZone:[1,5,1,""],Error:[1,4,1,""]},"roster_config_manager.dns_query_lib":{QueryFromZoneFile:[1,5,1,""],DnsQuery:[1,5,1,""]},"roster_config_manager.config_lib.ConfigLib":{FindNewestDnsTreeFilename:[1,2,1,""],ToolList:[1,1,1,""],FindDnsTreeFilename:[1,2,1,""],BIND_OPTION_CLAUSES:[1,1,1,""],TarDnsTree:[1,2,1,""],GetZoneList:[1,2,1,""],CheckDnsServer:[1,2,1,""],CHECKZONE_ARGS_DICT:[1,1,1,""],TarDnsBindFiles:[1,2,1,""],GetDnsServerInfo:[1,2,1,""],MergeOptionsDicts:[1,2,1,""],GetNamedZoneToolArgs:[1,2,1,""],COMMANDS_CONVERT_DICT:[1,1,1,""],GenerateAdditionalNamedCheckzoneArgs:[1,2,1,""],UnTarDnsTree:[1,2,1,""],FindAllDnsServers:[1,2,1,""],WriteDnsServerInfo:[1,2,1,""]},"roster_config_manager.config_lib":{ExporterNoFileError:[1,4,1,""],ServerCheckError:[1,4,1,""],ConfigLib:[1,3,1,""],QueryCheckError:[1,4,1,""],ExporterAuditIdError:[1,4,1,""],ExporterFileError:[1,4,1,""],ConfigManagerError:[1,4,1,""],ExporterFileNameError:[1,4,1,""],ExporterListFileError:[1,4,1,""]},"roster_config_manager.zone_importer_lib":{IncludeError:[1,4,1,""],ZoneImport:[1,3,1,""],Error:[1,4,1,""]},"roster_config_manager.__init__.ConfigLib":{FindNewestDnsTreeFilename:[1,2,1,""],ToolList:[1,1,1,""],FindDnsTreeFilename:[1,2,1,""],BIND_OPTION_CLAUSES:[1,1,1,""],TarDnsTree:[1,2,1,""],GetZoneList:[1,2,1,""],CHECKZONE_ARGS_DICT:[1,1,1,""],GetDnsServerInfo:[1,2,1,""],WriteDnsServerInfo:[1,2,1,""],TarDnsBindFiles:[1,2,1,""],MergeOptionsDicts:[1,2,1,""],UnTarDnsTree:[1,2,1,""],GetNamedZoneToolArgs:[1,2,1,""],COMMANDS_CONVERT_DICT:[1,1,1,""],GenerateAdditionalNamedCheckzoneArgs:[1,2,1,""],FindAllDnsServers:[1,2,1,""],CheckDnsServer:[1,2,1,""]},"roster_config_manager.db_recovery.Recover":{RunAuditRange:[1,2,1,""],PushBackup:[1,2,1,""],RunAuditStep:[1,2,1,""]},"roster_config_manager.__init__":{BindTreeExport:[1,3,1,""],ConfigLib:[1,3,1,""]},"roster_config_manager.__init__.BindTreeExport":{AddToTarFile:[1,2,1,""],NamedHeaderChangeDirectory:[1,2,1,""],CookData:[1,2,1,""],CookRawDump:[1,2,1,""],ListLatestNamedConfGlobalOptions:[1,2,1,""],SortRecords:[1,2,1,""],ExportAllBindTrees:[1,2,1,""],MakeNamedConf:[1,2,1,""],ListRecordArgumentDefinitions:[1,2,1,""],GetRawData:[1,2,1,""],ListACLNamesByView:[1,2,1,""]},roster_config_manager:{zone_exporter_lib:[1,0,1,""],dns_query_lib:[1,0,1,""],db_recovery:[1,0,1,""],config_lib:[1,0,1,""],zone_importer_lib:[1,0,1,""],tree_exporter:[1,0,1,""],"__init__":[1,0,1,""]},"roster_config_manager.zone_importer_lib.ZoneImport":{ReverseZoneToCIDRBlock:[1,2,1,""],MakeRecordsFromZone:[1,2,1,""]},"roster_config_manager.db_recovery":{Recover:[1,3,1,""]},"roster_config_manager.tree_exporter.BindTreeExport":{AddToTarFile:[1,2,1,""],NamedHeaderChangeDirectory:[1,2,1,""],GetRawData:[1,2,1,""],CookRawDump:[1,2,1,""],ListLatestNamedConfGlobalOptions:[1,2,1,""],SortRecords:[1,2,1,""],ExportAllBindTrees:[1,2,1,""],MakeNamedConf:[1,2,1,""],ListRecordArgumentDefinitions:[1,2,1,""],CookData:[1,2,1,""],ListACLNamesByView:[1,2,1,""]}},titleterms:{zone_exporter_lib:1,welcom:0,roster:0,config:0,modul:1,tabl:0,indic:0,packag:1,config_lib:1,db_recoveri:1,tree_export:1,document:0,roster_config_manag:1,manag:0,zone_importer_lib:1,dns_query_lib:1}})
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-core/docs/html/.buildinfo Mon Aug 19 17:06:11
2013 UTC
@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When
it is not found, a full rebuild will be done.
+config: 42b46f8b2b9834555075d41af560d14b
+tags: a205e9ed8462ae86fdd2f73488852ba9
=======================================
--- /dev/null
+++ /tags/release-0.18/roster-core/docs/html/_modules/index.html Mon Aug 19
17:06:11 2013 UTC
@@ -0,0 +1,100 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="
http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Overview: module code — Roster Core v0.18
documentation</title>
+
+ <link rel="stylesheet" href="../_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="../_static/pygments.css" type="text/css"
/>
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: '../',
+ VERSION: 'v0.18',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="../_static/jquery.js"></script>
+ <script type="text/javascript" src="../_static/underscore.js"></script>
+ <script type="text/javascript" src="../_static/doctools.js"></script>
+ <link rel="top" title="Roster Core v0.18 documentation"
href="../index.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../index.html">Roster Core v0.18 documentation</a>
»</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <h1>All modules for which code is available</h1>
+<ul><li><a href="roster_core/__init__.html">roster_core.__init__</a></li>
+<li><a href="roster_core/audit_log.html">roster_core.audit_log</a></li>
+<li><a href="roster_core/config.html">roster_core.config</a></li>
+<li><a href="roster_core/core.html">roster_core.core</a></li>
+<li><a
href="roster_core/core_helpers.html">roster_core.core_helpers</a></li>
+<li><a
href="roster_core/data_validation.html">roster_core.data_validation</a></li>
+<li><a href="roster_core/db_access.html">roster_core.db_access</a></li>
+<li><a href="roster_core/errors.html">roster_core.errors</a></li>
+<li><a href="roster_core/helpers_lib.html">roster_core.helpers_lib</a></li>
+<li><a
href="roster_core/punycode_lib.html">roster_core.punycode_lib</a></li>
+<li><a href="roster_core/user.html">roster_core.user</a></li>
+</ul>
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="../search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="../genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../index.html">Roster Core v0.18 documentation</a>
»</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2013, Purdue University.
+ Created using <a href="
http://sphinx-doc.org/">Sphinx</a> 1.2b1.
+ </div>
+ </body>
+</html>
=======================================
***Additional files exist in this changeset.***