From 3690f6c10df5a2d4c4087b73dba606548a3c51fd Mon Sep 17 00:00:00 2001
From: Jeffrey Altman <jaltman@secure-endpoints.com>
Date: Wed, 18 Apr 2007 21:45:22 +0000
Subject: [PATCH] More NIM Developer documentation updates

Revisions to the plug-in architecture documentation.

Adds a graphic showing the plug-in architecture

Defines "ALIASES" in the Makefile so that the current
NIM API Version number will be used within the docs
at build time.

ticket: new

git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@19490 dc483132-0cff-0310-8789-dd5450dbe970
---
 src/windows/identity/doc/Makefile             |   3 +
 .../doc/images/modules_plugins_krb5.png       | Bin 0 -> 22193 bytes
 src/windows/identity/doc/plugin_framework.h   | 132 ++++++++++++------
 src/windows/identity/doc/plugin_main.h        |  59 +++-----
 src/windows/identity/doc/plugin_structure.h   |  10 +-
 5 files changed, 124 insertions(+), 80 deletions(-)
 create mode 100644 src/windows/identity/doc/images/modules_plugins_krb5.png

diff --git a/src/windows/identity/doc/Makefile b/src/windows/identity/doc/Makefile
index 39b20a5aa..89380aff3 100644
--- a/src/windows/identity/doc/Makefile
+++ b/src/windows/identity/doc/Makefile
@@ -1,5 +1,6 @@
 #
 # Copyright (c) 2004 Massachusetts Institute of Technology
+# Copyright (c) 2007 Secure Endpoints Inc.
 #
 # Permission is hereby granted, free of charge, to any person
 # obtaining a copy of this software and associated documentation files
@@ -53,6 +54,8 @@ INPUT += "$(SRC)\kmm"
 INPUT += "$(SRC)\kherr"
 !ifdef BUILD_AFS
 INPUT += "$(SRC)\plugins\afs"
+
+ALIASES =  "apiversion=$(NETIDMGR_VERSION_API)"
 !endif
 
 IMAGE_PATH = "$(SRC)\doc\images"
diff --git a/src/windows/identity/doc/images/modules_plugins_krb5.png b/src/windows/identity/doc/images/modules_plugins_krb5.png
new file mode 100644
index 0000000000000000000000000000000000000000..127e89e8dd10faf16b794cce9eb838040de06fab
GIT binary patch
literal 22193
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

literal 0
HcmV?d00001

diff --git a/src/windows/identity/doc/plugin_framework.h b/src/windows/identity/doc/plugin_framework.h
index 39d6ac18f..a10af2a6f 100644
--- a/src/windows/identity/doc/plugin_framework.h
+++ b/src/windows/identity/doc/plugin_framework.h
@@ -28,75 +28,119 @@
 /*!
 \page pi_framework Plug-in Framework
 
-\section pi_fw_pnm Plug-ins and Modules
+\section pi_fw_pnm Introduction to Plug-ins, Modules and Messages
 
 \subsection pi_fw_pnm_p Plug-ins
 
-A Network Identity Manager plug-in is a package that implements a defined API that will
-perform credentials management or related tasks on behalf of Network Identity Manager.
-The core Network Identity Manager codebase does not interact directly with Kerberos v5 or
-AFS or any other external entity directly.  Instead, plug-ins are used.
+A plug-in is a package that implements a defined API that will perform
+credentials management or related tasks on behalf of Network Identity
+Manager.
 
-Each plug-in has a name.  The name should be unique among the loaded
-plug-ins, or the plug-in will fail to load.
+The Network Identity Manager architecture is message based.  The core
+of each plug-in is a message handler.  The plug-in integrates with the
+application by subscribing to, and handling specific types of
+messages.
 
-The method in which Network Identity Manager communicates with a plug-in depends on the
-plug-in type.  For more information on each plug-in type, please refer
-to \ref pi_pt.
-
-Most plug-in types rely on a message processor for communication.
-During plug-in registration, the module specifies the message processor
-for the plug-in, which acts as the only point of contact between the
-Network Identity Manager core and the plug-in.  Some other plug-ins require exporting
-specific functions.
+The plug-in message handler runs in its own thread and receive
+asynchronous messages.  There are exceptions, such as when one plug-in
+requires another plug-in to handle a specific message before it can
+handle the message.  In addition, during certain operations that
+require user interaction, each plug-in can delegate code that will run
+in the main application thread (the user interface thread) to process
+window messages.
 
 \subsection pi_fw_pnw_m Modules
 
 One or more plug-ins can be bundled together into a module.  A module
-is a dynamically loadable library which exports a specific
-set of callbacks.  Currently, the only two required callbacks for a
-module are :
+is a dynamically loadable library which exports a specific set of
+callbacks.  Currently, the only two required callbacks for a module
+are :
 
 - init_module(), and
 - exit_module()
 
-\section pi_fw_pm Plug-in/Module Manager
+For more information about how a module is structured, see \ref
+pi_structure .
+
+\subsection pi_fw_pnm_msg Messages and Message Queues
+
+An integral part of this framework is the messaging system.  Most of
+the communication between the Network Identity Manager application and
+plug-ins is conducted through passing messages.
+
+A message has a type and subtype and is denoted in this documentation
+as \< \e message_type, \e message_subtype\>.  For example, when a
+plug-in is loaded, the first message it receives is \< ::KMSG_SYSTEM,
+::KMSG_SYSTEM_INIT \>.
+
+Each thread in the application, specially threads that were created
+for individual plug-in messages handlers, has an associated message
+queue that stores and manages all the messages that have been sent to
+subscribers in that thread.
+
+The most common recipient of a message is a message callback function
+(see ::kmq_callback_t ). The message handler for a plug-in is one such
+example. A message callback function receives the message type,
+subtype and two optional parameters for the message.
+
+Any acceptable recipient can subscribe to broadcast messages of any
+type.  Once subscribed, whenever a message of that type is broadcast,
+the message will get queued on the corresponding message queue.  Then,
+one of the dispatch functions can dispatch the message to the correct
+callback function. (see ::kmq_dispatch).
+
+Next \subpage pi_fw_pm ...
 
-The plug-in manager maintains a separate thread for loading and
-registering modules.  When a module is successfully loaded and it
+*/
+
+/*!
+
+\page pi_fw_pm Module Manager
+
+The module manager is tasked with loading, unloading and managing the
+plug-in message processing. It maintains a separate thread for loading
+and registering modules.  When a module is successfully loaded and it
 registers one or more plug-ins, a new thread is created for each
 plug-in.  Plug-in specific initialization and other callback functions
-are called from within this new thread.  This is to prevent one plug-in
-from "hanging" other plug-ins and the main Network Identity Manager 
-user interface threads.
+are called from within this new thread.  This is to prevent one
+plug-in from "hanging" other plug-ins and the main Network Identity
+Manager user interface threads.
 
 Read more :
 - \ref pi_structure
 
 \subsection pi_fw_pm_load Load sequence
 
-When kmm_load_module() is called, the following sequence of events
-occur:
+When kmm_load_module() is called to load a specific module, the
+following sequence of events occur:
 
-- The standard system search path is used to locate the binary.
+- The registration information for the module is located on the
+  registry key \c
+  \Software\MIT\NetIDMgr\PluginManager\Modules\[ModuleName].
 
-- The binary is loaded into the address space of Network Identity Manager along with
-  any dependencies not already loaded.
+- The \c ImagePath value from the registration information is used to
+  locate the module binary.  If it is not an absolute path, then the
+  binary is located using the standard system search path starting
+  from the directory in which Network Identity Manager binaries are
+  located.
 
-- If the Network Identity Manager core binary is signed, then the signature is checked
-  against the system and user certificate stores.  If this fails, the
-  module is unloaded. See \ref pi_fw_pm_unload.
+- The binary is loaded into the address space of Network Identity
+  Manager along with any dependencies not already loaded.
 
-- init_module() for the loaded module is called.  If this function
-  returns an error or if no plug-ins are registered, then the module is
-  unloaded. See \ref pi_fw_pm_unload.
+- If the Network Identity Manager core binary is signed, then the
+  signature is checked against the system and user certificate stores.
+  If this fails, the module is unloaded. See \ref pi_fw_pm_unload.
+
+- The init_module() entry point for the loaded module is called.  If
+  this function returns an error or if no plug-ins are registered,
+  then the module is immediately unloaded. See \ref pi_fw_pm_unload.
 
 - During processing of init_module(), if any localized resource
   libraries are specified using kmm_set_locale_info(), then one of the
   localized libraries will be loaded. See \ref pi_localization
 
 - During processing of init_module(), the module registers all the
-  plug-ins that it is implementing by calling kmm_register_plug-in() for
+  plug-ins that it is implementing by calling kmm_register_plugin() for
   each.
 
 - Once init_module() returns, each plug-in is initialized.  The method
@@ -111,23 +155,29 @@ occur:
 - During normal operation, any registered plug-ins for a module can be
   unloaded explicitly, or the plug-in itself may signal that it should
   be unloaded.  If at anytime, all the plug-ins for the module are
-  unloaded, then the module itself is also unloaded unless the NoUnload
-  registry value is set in the module key.
+  unloaded, then the module itself is also unloaded unless the \c
+  NoUnload registry value is set in the module key.
 
 \subsection pi_fw_pm_unload Unload sequence
 
 - For each of the plug-ins that are registered for a module, the exit
   code is invoked.  The method by which this happens depends on the
-  plug-in type.  The plug-in is not given a chance to object to the
+  plug-in type.  The plug-in is not given a chance to veto the
   decision to unload. Each plug-in is responsible for performing
   cleanup tasks, freeing resources and unsubscribing from any message
   classes that it has subscribed to.
 
-- exit_module() is called for the module.
+- The exit_module() entry point is called for the module.
 
 - If any localized resource libraries were loaded for the module, they
   are unloaded.
 
 - The module is unloaded.
 
+The following diagram illustrates the relationship between modules and
+plug-ins as implemented in the Kerberos 5 plug-in distributed with
+Network Identity Manager.
+
+\image html modules_plugins_krb5.png
+
  */
diff --git a/src/windows/identity/doc/plugin_main.h b/src/windows/identity/doc/plugin_main.h
index feb4a25d3..70040b285 100644
--- a/src/windows/identity/doc/plugin_main.h
+++ b/src/windows/identity/doc/plugin_main.h
@@ -29,38 +29,42 @@
 
 \page plug-ins Network Identity Manager Modules and Plug-ins
 
-Plug-ins and localization are handled by the Network Identity Manager Module Manager
-API.  Each plug-in consists of a dynamically loadable library and zero
-or more associated resource libraries.
+  The Network Identity Manager application does not include any
+  ability to manage any specific type of credential.  Instead it
+  exposes a framework on which plug-ins can be implemented to manage
+  credentials.
 
-For more information about Network Identity Manager Plug-ins, see the following
-sections:
+  Plug-ins and localization are handled by the Network Identity
+  Manager Module Manager API.
 
-- \subpage pi_framework
-- \subpage pi_pt
-- \subpage pi_structure
-- \subpage pi_localization
+  The following sections describe plug-ins in detail:
+
+  - \subpage pi_framework
+  - \subpage pi_pt
+  - \subpage pi_structure
+  - \subpage pi_localization
 */
 
 /*! \page pi_pt Plug-in Types
 
-The types of plug-ins that are currently supported by Network Identity Manager are :
+The types of plug-ins that are currently supported by Network Identity
+Manager are :
 
 \section pi_pt_cred Credential Provider
 
 A credential provider plug-in essentially acts as an interface between
-Network Identity Manager and some entity which defines the credentials for the purpose
-of managing those credentials.
+Network Identity Manager and some entity which defines the credentials
+for the purpose of managing those credentials.
 
 There can be more than one credential provider in a module.
 
 \subsection pi_pt_cred_comm Communication
 
-Communication between Network Identity Manager and a credential provider occurs
-through a message processor.  When registering a credential provider,
-the module initialization code in init_module() specifies
-::KHM_PITYPE_CRED as the \a type member and sets \a msg_proc member to
-a valid message processor in the ::khm_plug-in record.
+Communication between Network Identity Manager and a credential
+provider occurs through a message processor.  When registering a
+credential provider, the module initialization code in init_module()
+specifies ::KHM_PITYPE_CRED as the \a type member and sets \a msg_proc
+member to a valid message processor in the ::khm_plugin record.
 
 \subsection pi_pt_cred_init Initialization
 
@@ -72,8 +76,8 @@ guaranteed to be the first message it receives.
 
 The callback function should return KHM_ERROR_SUCCESS if it
 initializes properly or some other value otherwise.  If the return
-value signals an error, then the plug-in is assume to not be loaded and
-immediately unregistered.
+value signals an error, then the plug-in is assumed to have failed
+initialization and is immediately unloaded.
 
 The message processor is automatically subscribed to the following
 message types:
@@ -86,7 +90,6 @@ obtain new credentials.  This is because other plug-ins that may depend
 on the new credential messages may not be loaded at this time. See the
 section on \ref cred_msgs for more information.
 
-
 \subsection pi_pt_cred_exit Uninitialization
 
 When the plug-in is to be removed, the module manager sends a
@@ -107,22 +110,6 @@ unsubscribed from as they are automatically removed.
 Since credential managers may receive privileged information, the
 signature requirements for credential managers are specially strict.
 
-\section pi_pt_conf Configuration Provider
-
-Provides configuration information.
-[TODO: fill in]
-
-\subsection pi_pt_conf_comm Communication
-[TODO: fill in]
-
-\subsection pi_pt_conf_init Initialization
-[TODO: fill in]
-
-\subsection pi_pt_conf_exit Uninitialization
-[TODO: fill in]
-
-\subsection pi_pt_conf_other Other Notes
-
 */
 
 
diff --git a/src/windows/identity/doc/plugin_structure.h b/src/windows/identity/doc/plugin_structure.h
index c82af7b69..452029e4f 100644
--- a/src/windows/identity/doc/plugin_structure.h
+++ b/src/windows/identity/doc/plugin_structure.h
@@ -29,9 +29,13 @@
 
 \page pi_structure Structure of a module
 
-A Network Identity Manager module is a dynamically loadable library with a
-specific set of exported symbols.  Each export symbol and general
-notes about writing a plug-in module are documented below.
+A Network Identity Manager module is a dynamically loadable library
+with a specific set of exported symbols.  Each export symbol and
+general notes about writing a plug-in module are documented below.
+
+\section pi_str_reg  Registration and Version Information
+
+[TODO]
 
 \section pi_str_init Initialization
 
-- 
2.26.2