CONTRIBUTING

   1 HOW TO CONTRIBUTE TO OpenSSL
   2 ----------------------------
   3
   4 Development is coordinated on the openssl-dev mailing list (see
   5 http://www.openssl.org for information on subscribing). If you
   6 would like to submit a patch, send it to rt@openssl.org with
   7 the string "[PATCH]" in the subject. Please be sure to include a
   8 textual explanation of what your patch does.
   9
  10 You can also make GitHub pull requests. If you do this, please also send mail to
  11 rt@openssl.org with a brief description and a link to the PR so that we can more
  12 easily keep track of it.
  13
  14 If you are unsure as to whether a feature will be useful for the general
  15 OpenSSL community please discuss it on the openssl-dev mailing list first.
  16 Someone may be already working on the same thing or there may be a good
  17 reason as to why that feature isn't implemented.
  18
  19 Patches should be as up to date as possible, preferably relative to the
  20 current Git or the last snapshot. They should follow our coding style
  21 (see https://www.openssl.org/policies/codingstyle.html) and compile without
  22 warnings using the --strict-warnings flag.  OpenSSL compiles on many
  23 varied platforms: try to ensure you only use portable features.
  24
  25 Note: For legal reasons, contributions from the US can be accepted only
  26 if a TSU notification and a copy of the patch are sent to crypt@bis.doc.gov
  27 (formerly BXA) with a copy to the ENC Encryption Request Coordinator;
  28 please take some time to look at
  29 http://www.bis.doc.gov/Encryption/PubAvailEncSourceCodeNofify.html [sic]
  30 and
  31 http://w3.access.gpo.gov/bis/ear/pdf/740.pdf (EAR Section 740.13(e))
  32 for the details. If "your encryption source code is too large to serve as
  33 an email attachment", they are glad to receive it by fax instead; hope you
  34 have a cheap long-distance plan.
  35
  36 Our preferred format for changes is "diff -u" output. You might
  37 generate it like this:
  38
  39 # cd openssl-work
  40 # [your changes]
  41 # ./Configure dist; make clean
  42 # cd ..
  43 # diff -ur openssl-orig openssl-work > mydiffs.patch