Index of  //timmersit.nl/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.C22-Mar-2010 18: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.C22-Mar-2010 18:3020,924C source
[TXT]CSM_CNTX.H22-Mar-2010 18:301,622C header
[TXT]CSM_CSPI.C22-Mar-2010 18:30118,320C source
[TXT]CSM_CSPI.H22-Mar-2010 18:3031,235C header
[TXT]CSM_DYNMDS.H22-Mar-2010 18:304,936C header
[TXT]CSM_KEYMGR.H22-Mar-2010 18:3010,236C header
[TXT]CSM_KEYPARSE.C22-Mar-2010 18:3064,507C source
[TXT]CSM_KEYPARSE.H22-Mar-2010 18:304,057C header
[TXT]CSM_SESN.C22-Mar-2010 18:3022,784C source
[TXT]CSM_SESN.H22-Mar-2010 18:305,143C header
[TXT]CSM_VECT.C22-Mar-2010 18:3040,999C source
[TXT]CSM_VECT.H22-Mar-2010 18:304,631C header
[TXT]FUNCSTUBS.C22-Mar-2010 18:3016,128C source
[TXT]KMGR_CALLOUTS.C22-Mar-2010 18:301,695C source
[TXT]MAF_ACL.H22-Mar-2010 18:311,893C header
[TXT]MAF_API.H22-Mar-2010 18:30101,952C header
[TXT]MAF_CALLOUTS.H22-Mar-2010 18:306,657C header
[TXT]MAF_COLLECTN.C22-Mar-2010 18:3027,283C source
[TXT]MAF_COLLECTN.H22-Mar-2010 18:307,027C header
[TXT]MAF_CONFIG.H17-Oct-2002 14:204,499C header
[TXT]MAF_DBG.C22-Mar-2010 18:301,023C source
[TXT]MAF_DBG.H22-Mar-2010 18:30350C header
[TXT]MAF_DLLMAIN.C22-Mar-2010 18:3084,581C source
[TXT]MAF_INCLUDE.H 7-Aug-2002 11:032,455C header
[TXT]MAF_INTEG.C22-Mar-2010 18:3032,721C source
[TXT]MAF_INTEG.H22-Mar-2010 18:301,890C header
[TXT]MAF_INTERFACE.H22-Mar-2010 18:307,661C header
[TXT]MAF_LIST.H22-Mar-2010 18:31678C header
[TXT]MAF_MDS.C22-Mar-2010 18:3022,824C source
[TXT]MAF_MDS.H22-Mar-2010 18:302,150C header
[TXT]MAF_MISC.C22-Mar-2010 18:3012,355C source
[TXT]MAF_MISC.H22-Mar-2010 18:312,676C header
[TXT]MAF_UTIL.H22-Mar-2010 18:309,157C header
[TXT]MAF_VALIDATE.C22-Mar-2010 18:3019,976C source
[TXT]MAF_VALIDATE.H22-Mar-2010 18:303,636C header
[TXT]MDS_UTIL.H22-Mar-2010 18:3124,092C header
[TXT]MODINSTALL.C22-Mar-2010 18:3013,367C source
[TXT]README.TXT 6-Jan-2003 12:433,286plain text
[TXT]STUBCSP.OPT 7-Aug-2002 11:03796VMS linker options