Index of  //wasd.vsm.com.au/sys$common/syshlp/examples/CDSA/ADDIN/*.*

****    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.

NameRevisedSizeDescription
[TXT]ACC_CRED.C23-Mar-2010 08:3033,922C source
[TXT]ADDIN_BUILD.COM 6-Jan-2003 15:172,758DCL procedure
[TXT]ADDIN_INSTALL.COM 7-Aug-2002 11:03488DCL procedure
[TXT]ADDIN_SIGN.COM13-Dec-2002 14:591,350DCL procedure
[TXT]CALLOUTS.C 7-Aug-2002 11:039,089C source
[TXT]CSM_CNTX.C23-Mar-2010 08:3020,924C source
[TXT]CSM_CNTX.H23-Mar-2010 08:301,622C header
[TXT]CSM_CSPI.C23-Mar-2010 08:30118,320C source
[TXT]CSM_CSPI.H23-Mar-2010 08:3031,235C header
[TXT]CSM_DYNMDS.H23-Mar-2010 08:304,936C header
[TXT]CSM_KEYMGR.H23-Mar-2010 08:3010,236C header
[TXT]CSM_KEYPARSE.C23-Mar-2010 08:3064,507C source
[TXT]CSM_KEYPARSE.H23-Mar-2010 08:304,057C header
[TXT]CSM_SESN.C23-Mar-2010 08:3022,784C source
[TXT]CSM_SESN.H23-Mar-2010 08:305,143C header
[TXT]CSM_VECT.C23-Mar-2010 08:3040,999C source
[TXT]CSM_VECT.H23-Mar-2010 08:304,631C header
[TXT]FUNCSTUBS.C23-Mar-2010 08:3016,128C source
[TXT]KMGR_CALLOUTS.C23-Mar-2010 08:301,695C source
[TXT]MAF_ACL.H23-Mar-2010 08:301,893C header
[TXT]MAF_API.H23-Mar-2010 08:30101,952C header
[TXT]MAF_CALLOUTS.H23-Mar-2010 08:306,657C header
[TXT]MAF_COLLECTN.C23-Mar-2010 08:3027,283C source
[TXT]MAF_COLLECTN.H23-Mar-2010 08:307,027C header
[TXT]MAF_CONFIG.H17-Oct-2002 14:204,499C header
[TXT]MAF_DBG.C23-Mar-2010 08:301,023C source
[TXT]MAF_DBG.H23-Mar-2010 08:30350C header
[TXT]MAF_DLLMAIN.C23-Mar-2010 08:3084,581C source
[TXT]MAF_INCLUDE.H 7-Aug-2002 11:032,455C header
[TXT]MAF_INTEG.C23-Mar-2010 08:3032,721C source
[TXT]MAF_INTEG.H23-Mar-2010 08:301,890C header
[TXT]MAF_INTERFACE.H23-Mar-2010 08:307,661C header
[TXT]MAF_LIST.H23-Mar-2010 08:30678C header
[TXT]MAF_MDS.C23-Mar-2010 08:3022,824C source
[TXT]MAF_MDS.H23-Mar-2010 08:302,150C header
[TXT]MAF_MISC.C23-Mar-2010 08:3012,355C source
[TXT]MAF_MISC.H23-Mar-2010 08:302,676C header
[TXT]MAF_UTIL.H23-Mar-2010 08:309,157C header
[TXT]MAF_VALIDATE.C23-Mar-2010 08:3019,976C source
[TXT]MAF_VALIDATE.H23-Mar-2010 08:303,636C header
[TXT]MDS_UTIL.H23-Mar-2010 08:3024,092C header
[TXT]MODINSTALL.C23-Mar-2010 08:3013,367C source
[TXT]README.TXT 6-Jan-2003 12:433,286plain text
[TXT]STUBCSP.OPT 7-Aug-2002 11:03796VMS linker options