diff options
author | Dr. David von Oheimb <David.von.Oheimb@siemens.com> | 2020-06-10 14:15:28 +0200 |
---|---|---|
committer | Dr. David von Oheimb <David.von.Oheimb@siemens.com> | 2020-07-05 11:29:43 +0200 |
commit | 036cbb6bbf30955abdcffaf6e52cd926d8d8ee75 (patch) | |
tree | 1929b9d33c7041858cbbed980f8c981d8eb77c3c /HACKING.md | |
parent | util/markdownlint.rb: Add two rule exceptions: MD023 and MD026 (diff) | |
download | openssl-036cbb6bbf30955abdcffaf6e52cd926d8d8ee75.tar.xz openssl-036cbb6bbf30955abdcffaf6e52cd926d8d8ee75.zip |
Rename NOTES*, README*, VERSION, HACKING, LICENSE to .md or .txt
Reviewed-by: Tim Hudson <tjh@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/12109)
Diffstat (limited to 'HACKING.md')
-rw-r--r-- | HACKING.md | 26 |
1 files changed, 26 insertions, 0 deletions
diff --git a/HACKING.md b/HACKING.md new file mode 100644 index 0000000000..abf199f541 --- /dev/null +++ b/HACKING.md @@ -0,0 +1,26 @@ + 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: + + ./Configure -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. |