| MODIFYING OPENSSL SOURCE | |
| ------------------------ | |
| This document describes the way to add custom modifications to OpenSSL sources. | |
| If you are adding new public functions to the custom library build, you need to | |
| either add a prototype in one of the existing OpenSSL header files; | |
| or provide a new header file and edit Configurations/unix-Makefile.tmpl to pick up that file. | |
| After that perform the following steps: | |
| ./config -Werror --strict-warnings [your-options] | |
| make update | |
| make | |
| make test | |
| "make update" ensures that your functions declarations are added to util/libcrypto.num or util/libssl.num | |
| If you plan to submit the changes you made to OpenSSL (see CONTRIBUTING), it's worth running: | |
| make doc-nits | |
| after running "make update" to ensure that documentation has correct format. | |
| "make update" also generates files related to OIDs (in the crypto/objects/ folder) and errors. | |
| If a merge error occurs in one of these generated files then the generated files need to be removed | |
| and regenerated using "make update". | |
| To aid in this process the generated files can be committed separately so they can be removed easily. |