← Back to branch summary

~ubuntu-branches/ubuntu/precise/mysql-5.1/precise

« back to all changes in this revision

Viewing changes to extra/yassl/README

  • Committer: Bazaar Package Importer
  • Author(s): Norbert Tretkowski
  • Date: 2010-03-17 14:56:02 UTC
  • Revision ID: james.westby@ubuntu.com-20100317145602-x7e30l1b2sb5s6w6
Tags: upstream-5.1.45
Import upstream version 5.1.45

Show diffs side-by-side

added added

removed removed

Lines of Context:
extra/yassl/README
 
1
*****************yaSSL Release notes, version 1.6.0 (2/22/07)
 
2
 
 
3
    This release of yaSSL contains bug fixes, portability enhancements, and
 
4
    better X509 support.
 
5
 
 
6
See normal  build instructions below under 1.0.6.
 
7
See libcurl build instructions below under 1.3.0 and note in 1.5.8.
 
8
 
 
9
*****************yaSSL Release notes, version 1.5.8 (1/10/07)
 
10
 
 
11
    This release of yaSSL contains bug fixes, portability enhancements, and
 
12
    support for GCC 4.1.1 and vs2005 sp1.
 
13
 
 
14
 
 
15
 
 
16
    Since yaSSL now supports zlib, as does libcur, the libcurl build test can
 
17
    fail if yaSSL is built with zlib support since the zlib library isn't 
 
18
    passed.  You can do two things to fix this: 
 
19
 
 
20
        1) build yaSSL w/o zlib --without-zlib
 
21
        2) or add flags to curl configure LDFLAGS="-lm -lz"
 
22
 
 
23
 
 
24
 
 
25
*****************yaSSL Release notes, version 1.5.0 (11/09/06)
 
26
 
 
27
    This release of yaSSL contains bug fixes, portability enhancements,
 
28
    and full TLS 1.1 support.  Use the functions:
 
29
 
 
30
        SSL_METHOD *TLSv1_1_server_method(void);
 
31
        SSL_METHOD *TLSv1_1_client_method(void);
 
32
    
 
33
    or the SSLv23 versions (even though yaSSL doesn't support SSL 2.0 the v23
 
34
    means to pick the highest of SSL 3.0, TLS 1.0, or TLS 1.1).
 
35
 
 
36
 
 
37
See normal  build instructions below under 1.0.6.
 
38
See libcurl build instructions below under 1.3.0.
 
39
 
 
40
 
 
41
 
 
42
****************yaSSL Release notes, version 1.4.5 (10/15/06)
 
43
 
 
44
 
 
45
    This release of yaSSL contains bug fixes, portability enhancements,
 
46
    zlib compression support, removal of assembly instructions at runtime if
 
47
    not supported, and initial TLS 1.1 support.
 
48
 
 
49
 
 
50
    Compression Notes:  yaSSL uses zlib for compression and the compression
 
51
    should only be used if yaSSL is at both ends because the implementation
 
52
    details aren't yet standard.  If you'd like to turn compression on use
 
53
    the SSL_set_compression() function on the client before calling
 
54
    SSL_connect().  If both the client and server were built with zlib support
 
55
    then the connection will use compression.  If the client isn't built with
 
56
    support then SSL_set_compression() will return an error (-1).
 
57
 
 
58
    To build yaSSL with zlib support on Unix simply have zlib support on your
 
59
    system and configure will find it if it's in the standard locations.  If
 
60
    it's somewhere else use the option ./configure --with-zlib=DIR.  If you'd
 
61
    like to disable compression support in yaSSL use ./configure --without-zlib.
 
62
 
 
63
    To build yaSSL with zlib support on Windows:
 
64
 
 
65
        1) download zlib from http://www.zlib.net/
 
66
        2) follow the instructions in zlib from projects/visualc6/README.txt
 
67
           for how to add the zlib project into the yaSSL workspace noting that
 
68
           you'll need to add configuration support for "Win32 Debug" and
 
69
           "Win32 Release" in note 3 under "To use:". 
 
70
        3) define HAVE_LIBZ when building yaSSL
 
71
 
 
72
 
 
73
See normal  build instructions below under 1.0.6.
 
74
See libcurl build instructions below under 1.3.0.
 
75
 
 
76
 
 
77
********************yaSSL Release notes, version 1.4.0 (08/13/06)
 
78
 
 
79
 
 
80
    This release of yaSSL contains bug fixes, portability enhancements,
 
81
    nonblocking connect and accept, better OpenSSL error mapping, and 
 
82
    certificate caching for session resumption.
 
83
 
 
84
See normal  build instructions below under 1.0.6.
 
85
See libcurl build instructions below under 1.3.0.
 
86
 
 
87
 
 
88
********************yaSSL Release notes, version 1.3.7 (06/26/06)
 
89
 
 
90
 
 
91
    This release of yaSSL contains bug fixes, portability enhancements,
 
92
    and libcurl 7.15.4 support (any newer versions may not build). 
 
93
 
 
94
See normal  build instructions below under 1.0.6.
 
95
See libcurl build instructions below under 1.3.0.
 
96
 
 
97
 
 
98
********************yaSSL Release notes, version 1.3.5 (06/01/06)
 
99
 
 
100
 
 
101
    This release of yaSSL contains bug fixes, portability enhancements,
 
102
    better libcurl support, and improved non-blocking I/O.
 
103
 
 
104
See normal  build instructions below under 1.0.6.
 
105
See libcurl build instructions below under 1.3.0.
 
106
 
 
107
 
 
108
********************yaSSL Release notes, version 1.3.0 (04/26/06)
 
109
 
 
110
 
 
111
    This release of yaSSL contains minor bug fixes, portability enhancements,
 
112
    and libcurl support.
 
113
 
 
114
See normal build instructions below under 1.0.6.
 
115
 
 
116
 
 
117
--To build for libcurl on Linux, Solaris, *BSD, Mac OS X, or Cygwin:
 
118
 
 
119
  To build for libcurl the library needs to be built without C++ globals since
 
120
  the linker will be called in a C context, also libcurl configure will expect
 
121
  OpenSSL library names so some symbolic links are created.
 
122
 
 
123
    ./configure --enable-pure-c
 
124
    make
 
125
    make openssl-links
 
126
 
 
127
    (then go to your libcurl home and tell libcurl about yaSSL build dir)
 
128
    ./configure --with-ssl=/yaSSL-BuildDir LDFLAGS=-lm
 
129
    make
 
130
 
 
131
 
 
132
--To build for libcurl on Win32:
 
133
 
 
134
    Simply add the yaSSL project as a dependency to libcurl, add 
 
135
    yaSSL-Home\include and yaSSL-Home\include\openssl to the include list, and
 
136
    define USE_SSLEAY and USE_OPENSSL
 
137
 
 
138
    please email todd@yassl.com if you have any questions.
 
139
    
 
140
 
 
141
*******************yaSSL Release notes, version 1.2.2 (03/27/06)
 
142
 
 
143
 
 
144
    This release of yaSSL contains minor bug fixes and portability enhancements.
 
145
 
 
146
See build instructions below under 1.0.6:
 
147
 
 
148
 
 
149
 
 
150
*******************yaSSL Release notes, version 1.2.0
 
151
 
 
152
 
 
153
    This release of yaSSL contains minor bug fixes, portability enhancements,
 
154
    Diffie-Hellman compatibility fixes for other servers and client,
 
155
    optimization improvements, and x86 ASM changes.
 
156
 
 
157
See build instructions below under 1.0.6:
 
158
 
 
159
 
 
160
 
 
161
*****************yaSSL Release notes, version 1.1.5
 
162
 
 
163
    This release of yaSSL contains minor bug fixes, portability enhancements,
 
164
    and user requested changes including the ability to add all certificates in
 
165
    a directory, more robust socket handling, no new overloading unless
 
166
    requested, and an SSL_VERIFY_NONE option.
 
167
 
 
168
 
 
169
See build instructions below under 1.0.6:
 
170
 
 
171
 
 
172
 
 
173
******************yaSSL Release notes, version 1.0.6
 
174
 
 
175
This release of yaSSL contains minor bug fixes, portability enhancements,
 
176
x86 assembly for ARC4, SHA, MD5, and RIPEMD, --enable-ia32-asm configure
 
177
option, and a security patch for certificate chain processing.
 
178
 
 
179
--To build on Linux, Solaris, *BSD, Mac OS X, or Cygwin:
 
180
 
 
181
    ./configure
 
182
    make
 
183
 
 
184
    run testsuite from yaSSL-Home/testsuite to test the build
 
185
 
 
186
to make a release build:
 
187
 
 
188
    ./configure --disable-debug
 
189
    make
 
190
 
 
191
    run testsuite from yaSSL-Home/testsuite to test the build
 
192
 
 
193
 
 
194
--To build on Win32
 
195
 
 
196
Choose (Re)Build All from the project workspace
 
197
 
 
198
run Debug\testsuite.exe from yaSSL-Home\testsuite to test the build
 
199
 
 
200
 
 
201
 
 
202
***************** yaSSL Release notes, version 1.0.5
 
203
 
 
204
This release of yaSSL contains minor bug fixes, portability enhancements,
 
205
x86 assembly for AES, 3DES, BLOWFISH, and TWOFISH, --without-debug configure
 
206
option, and --enable-kernel-mode configure option for using TaoCrypt with
 
207
kernel modules.
 
208
 
 
209
--To build on Linux, Solaris, *BSD, Mac OS X, or Cygwin:
 
210
 
 
211
    ./configure
 
212
    make
 
213
 
 
214
    run testsuite from yaSSL-Home/testsuite to test the build
 
215
 
 
216
to make a release build:
 
217
 
 
218
    ./configure --without-debug
 
219
    make
 
220
 
 
221
    run testsuite from yaSSL-Home/testsuite to test the build
 
222
 
 
223
 
 
224
--To build on Win32
 
225
 
 
226
Choose (Re)Build All from the project workspace
 
227
 
 
228
run Debug\testsuite.exe from yaSSL-Home\testsuite to test the build
 
229
 
 
230
 
 
231
******************yaSSL Release notes, version 1.0.1
 
232
 
 
233
This release of yaSSL contains minor bug fixes, portability enhancements,
 
234
GCC 3.4.4 support, MSVC 2003 support, and more documentation.
 
235
 
 
236
Please see build instructions in the release notes for 0.9.6 below.
 
237
 
 
238
 
 
239
******************yaSSL Release notes, version 1.0
 
240
 
 
241
This release of yaSSL contains minor bug fixes, portability enhancements,
 
242
GCC 4.0 support, testsuite, improvements, and API additions.
 
243
 
 
244
Please see build instructions in the release notes for 0.9.6 below.
 
245
 
 
246
 
 
247
******************yaSSL Release notes, version 0.9.9
 
248
 
 
249
This release of yaSSL contains minor bug fixes, portability enchancements,
 
250
MSVC 7 support, memory improvements, and API additions.
 
251
 
 
252
Please see build instructions in the release notes for 0.9.6 below.
 
253
 
 
254
 
 
255
******************yaSSL Release notes, version 0.9.8
 
256
 
 
257
This release of yaSSL contains minor bug fixes and portability enchancements.
 
258
 
 
259
Please see build instructions in the release notes for 0.9.6 below.
 
260
 
 
261
 
 
262
******************yaSSL Release notes, version 0.9.6
 
263
 
 
264
This release of yaSSL contains minor bug fixes, removal of STL support, and
 
265
removal of exceptions and rtti so that the library can be linked without the
 
266
std c++ library.
 
267
 
 
268
--To build on Linux, Solaris, FreeBSD, Mac OS X, or Cygwin
 
269
 
 
270
./configure
 
271
make
 
272
 
 
273
run testsuite from yaSSL-Home/testsuite to test the build
 
274
 
 
275
 
 
276
--To build on Win32
 
277
 
 
278
Choose (Re)Build All from the project workspace
 
279
 
 
280
run Debug\testsuite.exe from yaSSL-Home\testsuite to test the build
 
281
 
 
282
 
 
283
 
 
284
******************yaSSL Release notes, version 0.9.2
 
285
 
 
286
This release of yaSSL contains minor bug fixes, expanded certificate
 
287
verification and chaining, and improved documentation.
 
288
 
 
289
Please see build instructions in release notes 0.3.0.
 
290
 
 
291
 
 
292
 
 
293
******************yaSSL Release notes, version 0.9.0
 
294
 
 
295
This release of yaSSL contains minor bug fixes, client verification handling,
 
296
hex and base64 encoing/decoding, and an improved test suite.
 
297
 
 
298
Please see build instructions in release notes 0.3.0.
 
299
 
 
300
 
 
301
******************yaSSL Release notes, version 0.8.0
 
302
 
 
303
This release of yaSSL contains minor bug fixes, and initial porting effort to
 
304
64bit, BigEndian, and more UNIX systems.
 
305
 
 
306
Please see build instructions in release notes 0.3.0.
 
307
 
 
308
 
 
309
******************yaSSL Release notes, version 0.6.0
 
310
 
 
311
This release of yaSSL contains minor bug fixes, source cleanup, and binary beta
 
312
(1) of the yaSSL libraries.
 
313
 
 
314
Please see build instructions in release notes 0.3.0.
 
315
 
 
316
 
 
317
 
 
318
******************yaSSL Release notes, version 0.5.0
 
319
 
 
320
This release of yaSSL contains minor bug fixes, full session resumption
 
321
support, and initial testing suite support.
 
322
 
 
323
 
 
324
 
 
325
Please see build instructions in release notes 0.3.0.
 
326
 
 
327
 
 
328
 
 
329
******************yaSSL Release notes, version 0.4.0
 
330
 
 
331
This release of yaSSL contains minor bug fixes, an optional memory tracker,
 
332
an echo client and server with input/output redirection for load testing, 
 
333
and initial session caching support. 
 
334
 
 
335
 
 
336
Please see build instructions in release notes 0.3.0.
 
337
 
 
338
 
 
339
******************yaSSL Release notes, version 0.3.5
 
340
 
 
341
This release of yaSSL contains minor bug fixes and extensions to the crypto
 
342
library including a full test suite.
 
343
 
 
344
 
 
345
*******************yaSSL Release notes, version 0.3.0
 
346
 
 
347
This release of yaSSL contains minor bug fixes and extensions to the crypto
 
348
library including AES and an improved random number generator.  GNU autoconf
 
349
and automake are now used to simplify the build process on Linux.
 
350
 
 
351
*** Linux Build process
 
352
 
 
353
./configure
 
354
make
 
355
 
 
356
*** Windows Build process
 
357
 
 
358
open the yassl workspace and build the project
 
359
 
 
360
 
 
361
*******************yaSSL Release notes, version 0.2.9
 
362
 
 
363
This release of yaSSL contains minor bug fixes and extensions to the crypto
 
364
library.
 
365
 
 
366
See the notes at the bottom of this page for build instructions.
 
367
 
 
368
 
 
369
*******************yaSSL Release notes, version 0.2.5
 
370
 
 
371
This release of yaSSL contains minor bug fixes and a beta binary of the yaSSL
 
372
libraries for win32 and linux.
 
373
 
 
374
See the notes at the bottom of this page for build instructions.
 
375
 
 
376
 
 
377
 
 
378
*******************yaSSL Release notes, version 0.2.0
 
379
 
 
380
This release of yaSSL contains minor bug fixes and initial alternate crypto
 
381
functionality. 
 
382
 
 
383
*** Complete Build ***
 
384
 
 
385
See the notes in Readme.txt for build instructions.
 
386
 
 
387
*** Update Build ***
 
388
 
 
389
If you have already done a complete build of yaSSL as described in the release
 
390
0.0.1 - 0.1.0 notes and downloaded the update to 0.2.0, place the update file
 
391
yassl-update-0.2.0.tar.gz in the yaSSL home directory and issue the command:
 
392
 
 
393
gzip -cd yassl-update-0.2.0.tar.gz | tar xvf -
 
394
 
 
395
to update the previous release.
 
396
 
 
397
Then issue the make command on linux or rebuild the yaSSL project on Windows. 
 
398
 
 
399
*******************yaSSL Release notes, version 0.1.0
 
400
 
 
401
This release of yaSSL contains minor bug fixes, full client and server TLSv1
 
402
support including full ephemeral Diffie-Hellman support, SSL type RSA and DSS
 
403
signing and verification, and initial stunnel 4.05 build support.
 
404
 
 
405
 
 
406
 
 
407
*********************yaSSL Release notes, version 0.0.3
 
408
 
 
409
The third release of yaSSL contains minor bug fixes, client certificate
 
410
enhancements, and initial ephemeral Diffie-Hellman integration:
 
411
 
 
412
 
 
413
 
 
414
*********************
 
415
 
 
416
yaSSL Release notes, version 0.0.2
 
417
 
 
418
The second release of yaSSL contains minor bug fixes, client certificate
 
419
enhancements, session resumption, and improved TLS support including:
 
420
 
 
421
- HMAC for MD5 and SHA-1
 
422
- PRF (pseudo random function)
 
423
- Master Secret and Key derivation routines
 
424
- Record Authentication codes
 
425
- Finish verify data check
 
426
 
 
427
Once ephemeral RSA and DH are added yaSSL will be fully complaint with TLS.
 
428
 
 
429
 
 
430
 
 
431
**********************
 
432
 
 
433
yassl Release notes, version 0.0.1
 
434
 
 
435
The first release of yassl supports normal RSA mode SSLv3 connections with
 
436
support for SHA-1 and MD5 digests.  Ciphers include DES, 3DES, and RC4.
 
437
 
 
438
yassl uses the CryptoPP library for cryptography, the source is available at
 
439
www.cryptopp.com .
 
440
 
 
441
yassl uses CML (the Certificate Management Library) for x509 support.  More
 
442
features will be in future versions.  The CML source is available for download
 
443
from www.digitalnet.com/knowledge/cml_home.htm .
 
444
 
 
445
The next release of yassl will support the 3 lesser-used SSL connection modes;
 
446
HandShake resumption, Ephemeral RSA (or DH), and Client Authentication as well
 
447
as full support for TLS.  Backwards support for SSLv2 is not planned at this
 
448
time.
 
449
 
 
450
 
 
451
**********************
 
452
 
 
453
Building yassl on linux:
 
454
 
 
455
use the ./buildall script to build everything.
 
456
 
 
457
buildall will configure and build CML, CryptoPP, and yassl.  Testing was 
 
458
preformed with gcc version 3.3.2 on kernel 2.4.22.
 
459
 
 
460
 
 
461
**********************
 
462
 
 
463
Building yassl on Windows:
 
464
 
 
465
Testing was preformed on Windows 2000 with Visual C++ 6 sp5.
 
466
 
 
467
1) decompress esnacc_r16.tgz in place, see buildall for syntax if unsure
 
468
 
 
469
2) decompress smp_r23.tgz in place
 
470
 
 
471
3) unzip cryptopp51/crypto51.zip in place
 
472
 
 
473
4) Build SNACC (part of CML) using snacc_builds.dsw in the SNACC directory
 
474
 
 
475
5) Build SMP (part of CMP) using smp.dsw in the smp directory
 
476
 
 
477
6) Build yassl using yassl.dsw
 
478
 
 
479
 
 
480
**********************
 
481
 
 
482
examples, server and client:
 
483
 
 
484
Please see the server and client examples in both versions to see how to link
 
485
to yassl and the support libraries.  On linux do 'make server' and 'make
 
486
client' to build them. On Windows you will find the example projects in the
 
487
main workspace, yassl.dsw.
 
488
 
 
489
The example server and client are compatible with openssl.
 
490
 
 
491
 
 
492
**********************
 
493
 
 
494
Building yassl into mysql on linux:
 
495
 
 
496
Testing was done using mysql version 4.0.17.
 
497
 
 
498
alter openssl_libs in the configure file, line 21056. Change '-lssl -lcrypto'
 
499
to '-lyassl -lcryptopp -lcmapi -lcmlasn -lctil -lc++asn1'.
 
500
 
 
501
see build/config_command for the configure command used to configure mysql
 
502
please change /home/touska/ to the relevant directory of course.
 
503
 
 
504
add yassl/lib to the LD_LIBRARY_PATH because libmysql/conf_to_src does not
 
505
use the ssl lib directory though it does use the ssl libraries.
 
506
 
 
507
make
 
508
 
 
509
make install
 
510
 
 
511
 
 
512
*********************
 
513
 
 
514
License:  yassl is currently under the GPL, please see license information
 
515
in the source and include files.
 
516
 
 
517
 
 
518
*********************
 
519
 
 
520
Contact: please send comments or questions to Todd A Ouska at todd@yassl.com
 
521
and/or Larry Stefonic at larry@yassl.com or 425-741-6858.
 
522
 
 
523
 
 
524