
The file of this same name residing in the src/openssl098g was the starting point for this
porting effort.

1.) The OpenSSL v1.0.2e release has some missing symbolic links.  The following were added 
    in netos/netos/src/openssl102e/include/openssl:

    ln -s ../../crypto/ui/ui.h ./ui.h
    ln -s ../../crypto/ui/ui_compat.h ./ui_compat.h
    ln -s ../../crypto/camellia/camellia.h ./camellia.h
    ln -s ../../crypto/conf/conf.h ./conf.h
    ln -s ../../crypto/ec/ec.h ./ec.h
    ln -s ../../crypto/ecdh/ecdh.h ./ecdh.h
    ln -s ../../crypto/ecdsa/ecdsa.h ./ecdsa.h
    ln -s ../../crypto/mdc2/mdc2.h ./mdc2.h
    ln -s ../../crypto/modes/modes.h ./modes.h
    ln -s ../../crypto/pkcs7/pkcs7.h ./pkcs7.h
    ln -s ../../crypto/engine/engine.h ./engine.h
    ln -s ../../crypto/ocsp/ocsp.h ./ocsp.h
    ln -s ../../crypto/pkcs12/pkcs12.h ./pkcs12.h
    ln -s ../../crypto/seed/seed.h ./seed.h
    ln -s ../../crypto/srp/srp.h ./srp.h
    ln -s ../../crypto/ts/ts.h ./ts.h
    ln -s ../../crypto/txt_db/txt_db.h ./txt_db.h
    ln -s ../../crypto/whrlpool/whrlpool.h ./whrlpool.h
    ln -s ../../crypto/cmac/cmac.h ./cmac.h

    See also: https://mta.openssl.org/pipermail/openssl-users/2015-December/002428.html

2.) ALL file updates made as part of the porting work are commented with the text:

    "DIGI WDS PORT"

3.) Additional compile-line options were added to configure_netos - these had been added by
    Li Zhen in the 0.9.8g Makefile.b (which were hard to find because they were expected to
    be found in the configure_netos script; Makefile.b is not present in 1.0.2e).

4.) From the netos/netos directory, a recursive grep was done searching for all instances
    of the text "oepnssl098g" and "OPENSSL098G" in all files.  This lead to the discovery
    that quite a few Makefiles contained hard-coded references to include file directories 
    under src/openssl098g.  These dependencies all had to be updated to reference 
    openssl102e.

5.) NEVER do a "make depend"!  It will pollute all the sub-directory Makefiles with ^M and 
    that will cause numerous build failures.  That was discovered early-on in this process 
    and that mistake was never made again.

6.) The configure_netos tool is run when you need to modify the compilation options for the
    OpenSSL code.  It's not expected that will need to be done very often after the porting
    work was done.  The big impact of configure_netos is it re-generates the header file
    crypto/opensslconf.h that is necessary for the cryptography code to be built with the
    proper compilation settings, based-on the arguments passed to Configure in the
    configure_netos script.

    If/when you execute configure_netos it will also generate a new Makefile which will NOT 
    have the Digi Net+OS-specific logic to execute Makefile.bak and remove the timestamping
    from the OpenSSL libraries.  You will want to save-off the current Makefile, then run
    configure_netos and restore the saved Makefile.  You will likely get a complaint when
    you first do a make afterwards that Makefile is old - just touch the Makefile and try
    again.

    It would probably be a worthwhile improvement to the configure_netos script to have it
    automatically save-off the existing Makefile and restore it after Configure finishes.

    Also remember that the netos/src/ssl/Makefile uses the same build options for the 
    OpenSSL APIs.  Therefore if those build options change you should change them in the
    netos/src/ssl/Makefile as well.

7.) Ignore any/all files with .gpj extensions - they are for Green Hills.
