BIND 10 trac3006, updated. 7e343de52c027ac35f231f906cfdd19500e8b7c1 [3006] Add alt text for image

[BIND 10 source code commits]

The branch, trac3006 has been updated
       via  7e343de52c027ac35f231f906cfdd19500e8b7c1 (commit)
       via  46544d453c97522254fcbef13fb57c67be622cb5 (commit)
      from  bdf66e1261cd868e356392e478b0361fcca349b8 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 7e343de52c027ac35f231f906cfdd19500e8b7c1
Author: Mukund Sivaraman <muks at isc.org>
Date:   Wed Jun 19 05:24:09 2013 +0530

    [3006] Add alt text for image

commit 46544d453c97522254fcbef13fb57c67be622cb5
Author: Mukund Sivaraman <muks at isc.org>
Date:   Wed Jun 19 05:23:26 2013 +0530

    [3006] Add another sequence diagram

-----------------------------------------------------------------------

Summary of changes:
 doc/design/datasrc/Makefile.am             |    1 +
 doc/design/datasrc/auth-local.txt          |  140 ++++++++++++++++++++++++++++
 doc/design/datasrc/data-source-classes.txt |    4 +-
 3 files changed, 143 insertions(+), 2 deletions(-)
 create mode 100644 doc/design/datasrc/auth-local.txt

-----------------------------------------------------------------------
diff --git a/doc/design/datasrc/Makefile.am b/doc/design/datasrc/Makefile.am
index e4e9150..71db317 100644
--- a/doc/design/datasrc/Makefile.am
+++ b/doc/design/datasrc/Makefile.am
@@ -1,5 +1,6 @@
 UML_FILES = \
 	overview.txt \
+	auth-local.txt \
 	auth-mapped.txt
 
 TEXT_FILES = \
diff --git a/doc/design/datasrc/auth-local.txt b/doc/design/datasrc/auth-local.txt
new file mode 100644
index 0000000..1f58d3a
--- /dev/null
+++ b/doc/design/datasrc/auth-local.txt
@@ -0,0 +1,140 @@
+ at startuml
+
+participant auth as "b10-auth"
+[-> auth: new/initial config\n(datasrc cfg)
+activate auth
+
+participant list as "Configurable\nClientList"
+create list
+auth -> list: <<construct>>
+
+auth -> list: configure(cfg)
+activate list
+
+create CacheConfig
+list -> CacheConfig: <<construct>> (cfg)
+
+participant zt_segment as "ZoneTable\nSegment\n(Local)"
+create zt_segment
+list -> zt_segment: <<construct>>
+activate zt_segment
+
+create ZoneTable
+zt_segment -> ZoneTable: <<construct>>
+
+deactivate zt_segment
+
+list -> zt_segment: isWritable()
+activate zt_segment
+note over zt_segment: Local segments are\nalways writable
+zt_segment --> list: true
+deactivate zt_segment
+
+loop for each zone in CacheConfig
+list -> CacheConfig: getLoadAction()
+activate CacheConfig
+
+create LoadAction
+CacheConfig -> LoadAction: <<construct>>
+
+participant LoadAction.2
+
+CacheConfig --> list : LoadAction
+
+deactivate CacheConfig
+
+create ZoneWriter
+list -> ZoneWriter: <<construct>> (load_action)
+
+participant ZoneWriter.2
+
+list -> ZoneWriter: load()
+activate ZoneWriter
+ZoneWriter -> LoadAction: (funcall)
+activate LoadAction
+
+create ZoneData
+LoadAction -> ZoneData: <<construct>> via helpers
+
+participant ZoneData.2
+
+LoadAction --> ZoneWriter: ZoneData
+deactivate LoadAction
+deactivate ZoneWriter
+
+list -> ZoneWriter: install()
+activate ZoneWriter
+
+ZoneWriter -> ZoneTable: addZone(ZoneData)
+activate ZoneTable
+ZoneTable --> ZoneWriter: NULL (no old data)
+deactivate ZoneTable
+
+deactivate ZoneWriter
+
+end
+
+deactivate list
+deactivate auth
+
+...
+
+[-> auth: reload\n(zonename)
+activate auth
+
+auth -> list: getCachedZoneWriter\n(zone_name)
+activate list
+
+list -> CacheConfig: getLoadAction()
+activate CacheConfig
+
+create LoadAction.2
+CacheConfig -> LoadAction.2: <<construct>>
+
+CacheConfig --> list : LoadAction.2
+
+deactivate CacheConfig
+
+create ZoneWriter.2
+list -> ZoneWriter.2: <<construct>> (load_action)
+
+list --> auth: ZoneWriter.2
+
+deactivate list
+
+
+
+
+
+auth -> ZoneWriter.2: load()
+activate ZoneWriter.2
+ZoneWriter.2 -> LoadAction.2: (funcall)
+activate LoadAction.2
+
+create ZoneData.2
+LoadAction.2 -> ZoneData.2: <<construct>> via helpers
+
+LoadAction.2 --> ZoneWriter.2: ZoneData.2
+deactivate LoadAction.2
+deactivate ZoneWriter.2
+
+auth -> ZoneWriter.2: install()
+activate ZoneWriter.2
+
+ZoneWriter.2 -> ZoneTable: addZone(ZoneData.2)
+activate ZoneTable
+ZoneTable --> ZoneWriter.2: ZoneData (old data)
+deactivate ZoneTable
+
+deactivate ZoneWriter.2
+
+auth -> ZoneWriter.2: cleanup()
+activate ZoneWriter.2
+
+ZoneWriter.2 -> ZoneData: <<destroy>>
+destroy ZoneData
+deactivate ZoneWriter.2
+
+deactivate auth
+
+ at enduml
diff --git a/doc/design/datasrc/data-source-classes.txt b/doc/design/datasrc/data-source-classes.txt
index 20f9e01..ac7e5a9 100644
--- a/doc/design/datasrc/data-source-classes.txt
+++ b/doc/design/datasrc/data-source-classes.txt
@@ -19,7 +19,7 @@ Overall relationships between classes
 The following diagram shows major classes in the data source library
 related to in-memory caches and their relationship.
 
-image::overview.png[]
+image::overview.png[Class diagram showing overview of relationships]
 
 Major design decisions of this architecture are:
 
@@ -173,7 +173,7 @@ class) to represent the server application behavior.  For the purpose
 of this document that should be sufficient.  The same note applies to
 all examples below.
 
-image::auth-local.png[]
+image::auth-local.png[Sequence diagram for auth server using local memory segment]
 
 1. On startup, the auth module creates a `ConfigurableClientList`
    for each RR class specified in the configuration for "data_sources"