README 4.0 KB
Newer Older
1

R
Richard Levitte 已提交
2
 OpenSSL 1.1.0-pre3 (alpha) 15 Feb 2016
3

4
 Copyright (c) 1998-2016 The OpenSSL Project
5
 Copyright (c) 1995-1998 Eric A. Young, Tim J. Hudson
6 7
 All rights reserved.

8 9 10
 DESCRIPTION
 -----------

R
Ralf S. Engelschall 已提交
11
 The OpenSSL Project is a collaborative effort to develop a robust,
12
 commercial-grade, fully featured, and Open Source toolkit implementing the
R
Rich Salz 已提交
13
 Secure Sockets Layer (SSLv3) and Transport Layer Security (TLS) protocols as
Z
Zhao Junwang 已提交
14
 well as a full-strength general purpose cryptographic library. The project is
R
Rich Salz 已提交
15 16 17
 managed by a worldwide community of volunteers that use the Internet to
 communicate, plan, and develop the OpenSSL toolkit and its related
 documentation.
18

R
Rich Salz 已提交
19
 OpenSSL is descended from the SSLeay library developed by Eric A. Young
20
 and Tim J. Hudson.  The OpenSSL toolkit is licensed under a dual-license (the
R
Rich Salz 已提交
21 22 23
 OpenSSL license plus the SSLeay license), which means that you are free to
 get and use it for commercial and non-commercial purposes as long as you
 fulfill the conditions of both licenses.
24

25 26 27
 OVERVIEW
 --------

28
 The OpenSSL toolkit includes:
29 30

 libssl.a:
R
Rich Salz 已提交
31
     Provides the client and server-side implementations for SSLv3 and TLS.
32 33

 libcrypto.a:
R
Rich Salz 已提交
34 35
     Provides general cryptographic and X.509 support needed by SSL/TLS but
     not logically part of it.
36

B
Bodo Möller 已提交
37
 openssl:
38
     A command line tool that can be used for:
R
Rich Salz 已提交
39
        Creation of key parameters
B
Bodo Möller 已提交
40
        Creation of X.509 certificates, CSRs and CRLs
R
Rich Salz 已提交
41 42 43
        Calculation of message digests
        Encryption and decryption
        SSL/TLS client and server tests
44
        Handling of S/MIME signed or encrypted mail
R
Rich Salz 已提交
45
        And more...
46

47 48 49
 INSTALLATION
 ------------

R
Rich Salz 已提交
50 51 52 53 54 55
 See the appropriate file:
        INSTALL         Linux, Unix, etc.
        INSTALL.DJGPP   DOS platform with DJGPP
        INSTALL.NW      Netware
        INSTALL.OS2     OS/2
        INSTALL.VMS     VMS
56
        INSTALL.WIN     Windows
R
Rich Salz 已提交
57
        INSTALL.WCE     Windows CE
58

B
Bodo Möller 已提交
59
 SUPPORT
60 61
 -------

R
Rich Salz 已提交
62
 See the OpenSSL website www.openssl.org for details on how to obtain
63 64
 commercial technical support.

65 66 67
 If you have any problems with OpenSSL then please take the following steps
 first:

68 69
    - Download the current snapshot from ftp://ftp.openssl.org/snapshot/
      to see if the problem has already been addressed
70
    - Remove ASM versions of libraries
B
Bodo Möller 已提交
71
    - Remove compiler optimisation flags
72 73 74 75

 If you wish to report a bug then please include the following information in
 any bug report:

76 77 78 79 80 81 82 83 84
    - On Unix systems:
        Self-test report generated by 'make report'
    - On other systems:
        OpenSSL version: output of 'openssl version -a'
        OS Name, Version, Hardware platform
        Compiler Details (name, version)
    - Application Details (name, version)
    - Problem Description (steps that will reproduce the problem, if known)
    - Stack Traceback (if the application dumps core)
85

R
Rich Salz 已提交
86
 Email the report to:
87

88
    rt@openssl.org
89

90 91
 In order to avoid spam, this is a moderated mailing list, and it might
 take a day for the ticket to show up.  (We also scan posts to make sure
R
Rich Salz 已提交
92 93 94 95 96 97
 that security disclosures aren't publically posted by mistake.) Mail
 to this address is recorded in the public RT (request tracker) database
 (see https://www.openssl.org/community/index.html#bugs for details) and
 also forwarded the public openssl-dev mailing list.  Confidential mail
 may be sent to openssl-security@openssl.org (PGP key available from the
 key servers).
98

99 100 101 102 103 104 105
 Please do NOT use this for general assistance or support queries.
 Just because something doesn't work the way you expect does not mean it
 is necessarily a bug in OpenSSL.

 You can also make GitHub pull requests. If you do this, please also send
 mail to rt@openssl.org with a link to the PR so that we can more easily
 keep track of it.
106

U
Ulf Möller 已提交
107 108 109
 HOW TO CONTRIBUTE TO OpenSSL
 ----------------------------

110
 See CONTRIBUTING
R
Rich Salz 已提交
111 112 113 114 115 116 117 118

 LEGALITIES
 ----------

 A number of nations, in particular the U.S., restrict the use or export
 of cryptography. If you are potentially subject to such restrictions
 you should seek competent professional legal advice before attempting to
 develop or distribute cryptographic code.