xref: /external/oj-libjdwp/src/share/npt

README: For NPT Library.
------------------------

To use this Native Platform Toolkit library, you need to add 
-Isrc/share/npt and -I/src/${platform}/npt (platform is solaris or windows)
to your compilation lines.

To initialize/use the library:

    #include "npt.h"
    
    NptEnv *npt;
    
    NPT_INITIALIZE(&npt, NPT_VERSION, NULL);
    if (npt == NULL) {
        FATAL_ERROR_MESSAGE(("Unable to gain access to Npt library"));
    }

    /* To use the npt utf functions, they require initialization */
    npt->utf = (npt->utfInitialize)(NULL);
    if (npt->utf == NULL) {
        FATAL_ERROR_MESSAGE(("Unable to gain access to Npt utf functions"));
    }

    ...


    /* After all uses is done, it can be terminated, however, if the
     *   process will be exiting anyway it isn't necessary, and if
     *   you have other threads running that might use these handles
     *   you will need to wait here until all those threads have terminated.
     *   So in general, termination can be a pain and slow your process
     *   termination down.
     */
    (npt->utfTerminate)(npt->utf,NULL);
    NPT_TERMINATE(&npt, NULL);