**** ADDIN_README.TXT ****
This CDSA example is an addin module written to the CDSA
CSP Service Provider Interface (with integrity checking).
It would be 'loaded' and 'attached' by an application, in
the same way that the des examples do, using CSSM_ModuleLoad,
CSSM_ModuleAttach, etc..
It's purpose is to demonstrate the mechanics of developing
a CDSA addin module (which on OpenVMS is a shareable image).
It also provides the necessary CDSA code files that would be
necessary to build an addin module.
The installation procedure will verify that it is built
correctly. It will attach the module and execute
RegisterCDSAModule(), (the definition of INSTALL_ENTRY_NAME).
********************
** Special Note **
********************
Sys$common:[syshlp.examples.cdsa]readme.txt contains general
information that applies to all of the example programs that are signed.
The necessary files to build the example on OpenVMS are included,
with the exception of modselfkey.h. This include file must be
generated from the certificate created for the addin module(s).
See the OpenVMS book "Open Source Security for OpenVMS, Volume 1: Common Data
Security Architecture", CDSA Programing Concepts, for complete instructions.
Special attention should be paid to the section on Signed Application Development.
A signed CDSA application will not execute until the proper credentials are
generated.
The ADDIN example files are:
ACC_CRED.C CSM_CNTX.H ADDIN_BUILD.COM
CALLOUTS.C CSM_CSPI.H ADDIN_SIGN.COM
CSM_CNTX.C CSM_DYNMDS.H ADDIN_INSTALL.COM
CSM_CSPI.C CSM_KEYMGR.H STUBCSP.OPT
CSM_KEYPARSE.C CSM_KEYPARSE.H
CSM_SESN.C CSM_SESN.H
CSM_VECT.C CSM_VECT.H
FUNCSTUBS.C MAF_ACL.H
KMGR_CALLOUTS.C MAF_API.H
MAF_COLLECTN.C MAF_CALLOUTS.H
MAF_DBG.C MAF_COLLECTN.H
MAF_DLLMAIN.C MAF_CONFIG.H
MAF_INTEG.C MAF_DBG.H
MAF_MDS.C MAF_INCLUDE.H
MAF_MISC.C MAF_INTEG.H
MAF_VALIDATE.C MAF_INTERFACE.H
MODINSTALL.C MAF_LIST.H
MAF_MDS.H
MAF_MISC.H
MAF_UTIL.H
MAF_VALIDATE.H
MDS_UTIL.H
(MODSELFKEY.H not provided, user generated)
After performing the steps to generate the application credentials
and the include file, modselfkey.h, the ADDIN example program
can be built by copying the example files to a local build
area, and executing the ADDIN_BUILD command file, as follows:
$ define/trans=conceal cdsa_tempdir :[.]
$ set default cdsa_tempdir:[addin]
$ copy SYS$SYSROOT:[SYSHLP.EXAMPLES.CDSA.ADDIN]*.* []
$ copy CDSA_SYSDIR:[SIGN]MODSELFKEY.H []
$ @ADDIN_BUILD
The resulting shareable image is STUBCSP300_SHR.EXE.
**************
On the SIGNING SYSTEM run the command procedure to generate the manifest.
**************
$ @ADDIN_SIGN
Finally back on the development system run the command procedure
to install the module.
$ @ADDIN_INSTALL
The addin module is now ready to be invoked by an application program.
Name Created Size Description
![[TXT]](/httpd/-/text.gif)
ACC_CRED.C 23-Mar-2010 08:30 33,922 C source
ADDIN_BUILD.COM 6-Jan-2003 15:17 2,758 DCL procedure
ADDIN_INSTALL.COM 6-Aug-2002 15:28 488 DCL procedure
ADDIN_SIGN.COM 13-Dec-2002 14:59 1,350 DCL procedure
CALLOUTS.C 2-Aug-2002 17:18 9,089 C source
CSM_CNTX.C 23-Mar-2010 08:30 20,924 C source
CSM_CNTX.H 23-Mar-2010 08:30 1,622 C header
CSM_CSPI.C 23-Mar-2010 08:30 118,320 C source
CSM_CSPI.H 23-Mar-2010 08:30 31,235 C header
CSM_DYNMDS.H 23-Mar-2010 08:30 4,936 C header
CSM_KEYMGR.H 23-Mar-2010 08:30 10,236 C header
CSM_KEYPARSE.C 23-Mar-2010 08:30 64,507 C source
CSM_KEYPARSE.H 23-Mar-2010 08:30 4,057 C header
CSM_SESN.C 23-Mar-2010 08:30 22,784 C source
CSM_SESN.H 23-Mar-2010 08:30 5,143 C header
CSM_VECT.C 23-Mar-2010 08:30 40,999 C source
CSM_VECT.H 23-Mar-2010 08:30 4,631 C header
FUNCSTUBS.C 23-Mar-2010 08:30 16,128 C source
KMGR_CALLOUTS.C 23-Mar-2010 08:30 1,695 C source
MAF_ACL.H 23-Mar-2010 08:30 1,893 C header
MAF_API.H 23-Mar-2010 08:30 101,952 C header
MAF_CALLOUTS.H 23-Mar-2010 08:30 6,657 C header
MAF_COLLECTN.C 23-Mar-2010 08:30 27,283 C source
MAF_COLLECTN.H 23-Mar-2010 08:30 7,027 C header
MAF_CONFIG.H 17-Oct-2002 14:20 4,499 C header
MAF_DBG.C 23-Mar-2010 08:30 1,023 C source
MAF_DBG.H 23-Mar-2010 08:30 350 C header
MAF_DLLMAIN.C 23-Mar-2010 08:30 84,581 C source
MAF_INCLUDE.H 2-Aug-2002 17:22 2,455 C header
MAF_INTEG.C 23-Mar-2010 08:30 32,721 C source
MAF_INTEG.H 23-Mar-2010 08:30 1,890 C header
MAF_INTERFACE.H 23-Mar-2010 08:30 7,661 C header
MAF_LIST.H 23-Mar-2010 08:30 678 C header
MAF_MDS.C 23-Mar-2010 08:30 22,824 C source
MAF_MDS.H 23-Mar-2010 08:30 2,150 C header
MAF_MISC.C 23-Mar-2010 08:30 12,355 C source
MAF_MISC.H 23-Mar-2010 08:30 2,676 C header
MAF_UTIL.H 23-Mar-2010 08:30 9,157 C header
MAF_VALIDATE.C 23-Mar-2010 08:30 19,976 C source
MAF_VALIDATE.H 23-Mar-2010 08:30 3,636 C header
MDS_UTIL.H 23-Mar-2010 08:30 24,092 C header
MODINSTALL.C 23-Mar-2010 08:30 13,367 C source
README.TXT 6-Jan-2003 12:43 3,286 plain text
STUBCSP.OPT 7-Aug-2002 11:03 796 VMS linker options