]>
Commit | Line | Data |
---|---|---|
71368339 RL |
1 | OpenSSL User Support resources |
2 | ============================== | |
3 | ||
efb4667f RL |
4 | See the <https://www.openssl.org/support/contracts.html> for details on how to |
5 | obtain commercial technical support. | |
be0c6a36 | 6 | |
efb4667f RL |
7 | If you have general questions about using OpenSSL |
8 | ------------------------------------------------- | |
be0c6a36 | 9 | |
6c8149df | 10 | In this case the [openssl-users] mailing list is the right place for you. |
be0c6a36 DMSP |
11 | The list is not only watched by the OpenSSL team members, but also by many |
12 | other OpenSSL users. Here you will most likely get the answer to your questions. | |
13 | An overview over the [mailing lists](#mailing-lists) can be found below. | |
14 | ||
efb4667f RL |
15 | If you think you found a Bug |
16 | ---------------------------- | |
be0c6a36 | 17 | |
efb4667f RL |
18 | *NOTE: this section assumes that you want to report it or figure it out and |
19 | fix it. What's written here is not to be taken as a recipe for how to get a | |
20 | working production installation* | |
21 | ||
22 | If you have any problems with OpenSSL then please take the following steps | |
23 | first: | |
be0c6a36 DMSP |
24 | |
25 | - Search the mailing lists and/or the GitHub issues to find out whether | |
26 | the problem has already been reported. | |
27 | - Download the latest version from the repository to see if the problem | |
28 | has already been addressed. | |
29 | - Configure without assembler support (`no-asm`) and check whether the | |
30 | problem persists. | |
31 | - Remove compiler optimization flags. | |
32 | ||
33 | Please keep in mind: Just because something doesn't work the way you expect | |
34 | does not mean it is necessarily a bug in OpenSSL. If you are not sure, | |
35 | consider searching the mail archives and posting a question to the | |
6c8149df | 36 | [openssl-users] mailing list first. |
be0c6a36 DMSP |
37 | |
38 | ### Open an Issue | |
39 | ||
40 | If you wish to report a bug, please open an [issue][github-issues] on GitHub | |
41 | and include the following information: | |
42 | ||
43 | - OpenSSL version: output of `openssl version -a` | |
44 | - Configuration data: output of `perl configdata.pm --dump` | |
45 | - OS Name, Version, Hardware platform | |
46 | - Compiler Details (name, version) | |
47 | - Application Details (name, version) | |
48 | - Problem Description (steps that will reproduce the problem, if known) | |
49 | - Stack Traceback (if the application dumps core) | |
50 | ||
51 | Not only errors in the software, also errors in the documentation, in | |
52 | particular the manual pages, can be reported as issues. | |
53 | ||
54 | ### Submit a Pull Request | |
55 | ||
56 | The fastest way to get a bug fixed is to fix it yourself ;-). If you are | |
57 | experienced in programming and know how to fix the bug, you can open a | |
58 | pull request. The details are covered in the [Contributing](#contributing) section. | |
59 | ||
60 | Don't hesitate to open a pull request, even if it's only a small change | |
61 | like a grammatical or typographical error in the documentation. | |
62 | ||
be0c6a36 DMSP |
63 | Mailing Lists |
64 | ============= | |
65 | ||
6c8149df | 66 | The OpenSSL maintains a number of [mailing lists] for various purposes. |
be0c6a36 DMSP |
67 | The most important lists are: |
68 | ||
6c8149df DMSP |
69 | - [openssl-users] for general questions about using the OpenSSL software |
70 | and discussions between OpenSSL users. | |
be0c6a36 | 71 | |
6c8149df | 72 | - [openssl-announce] for official announcements to the OpenSSL community. |
be0c6a36 | 73 | |
6c8149df DMSP |
74 | - [openssl-project] for discussion about the development roadmap |
75 | and governance. | |
be0c6a36 | 76 | |
efb4667f RL |
77 | Only subscribers can post to [openssl-users] or [openssl-project]. The |
78 | archives are made public, however. For more information, see the [mailing | |
79 | lists] page. | |
be0c6a36 | 80 | |
efb4667f RL |
81 | There was an [openssl-dev] list that has been discontinued since development |
82 | is now taking place in the form of GitHub pull requests. Although not active | |
83 | anymore, the searchable archive may still contain useful information. | |
be0c6a36 | 84 | |
be0c6a36 DMSP |
85 | <!-- Links --> |
86 | ||
87 | [mailing lists]: https://www.openssl.org/community/mailinglists.html | |
88 | [openssl-users]: https://mta.openssl.org/mailman/listinfo/openssl-users | |
89 | [openssl-announce]: https://mta.openssl.org/mailman/listinfo/openssl-announce | |
90 | [openssl-project]: https://mta.openssl.org/mailman/listinfo/openssl-project | |
91 | [openssl-dev]: https://mta.openssl.org/mailman/listinfo/openssl-dev |