Bump actions/upload-artifacts version
[libtommath.git] / changes.txt
blobdf2735daf443b7335d3544f25e32b21ec98b50b4
1 Mar 27th, 2024
2 v1.3.0
3        -- Deprecate more APIs which are replaced in develop (PR #572)
4        -- Add support for CMake (PR #573)
5        -- Add support for GitHub Actions (PR #573)
7 Sep 04th, 2023
8 v1.2.1
9        -- Bugfix release because of potential integer overflow
10           c.f. PR #546 resp. CVE-2023-36328
12 Oct 22nd, 2019
13 v1.2.0
14        -- A huge refactoring of the library happened - renaming,
15           deprecating and replacing existing functions by improved API's.
17           All deprecated functions, macros and symbols are only marked as such
18           so this version is still API and ABI compatible to v1.x.
20        -- Daniel Mendler was pushing for those changes and contributing a load of patches,
21           refactorings, code reviews and whatnotelse.
22        -- Christoph Zurnieden re-worked internals of the library, improved the performance,
23           did code reviews and wrote documentation.
24        -- Francois Perrad did some refactoring and took again care of linting the sources and
25           provided all fixes.
26        -- Jan Nijtmans, Karel Miko and Joachim Breitner contributed various patches.
28        -- Private symbols can now be hidden for the shared library builds, disabled by default.
29        -- All API's follow a single code style, are prefixed the same etc.
30        -- Unified, safer and improved API's
31        -- Less magic numbers - return values (where appropriate) and most flags are now enums,
32           this was implemented in a backwards compatible way where return values were int.
33        -- API's with return values are now by default marked as "warn on unused result", this
34           can be disabled if required (which will most likely hide bugs), c.f. MP_WUR in tommath.h
35        -- Provide a whole set of setters&getters for different primitive types (long, uint32_t, etc.)
36        -- All those primitive setters are now optimized.
37        -- It's possible to automatically tune the cutoff values for Karatsuba&Toom-Cook
38        -- The custom allocators which were formerly known as XMALLOC(), XFREE() etc. are now available
39           as MP_MALLOC(), MP_REALLOC(), MP_CALLOC() and MP_FREE(). MP_REALLOC() and MP_FREE() now also
40           provide the allocated size to ease the usage of simple allocators without tracking.
41        -- Building is now also possible with MSVC 2015, 2017 and 2019 (use makefile.msvc)
42        -- Added mp_decr() and mp_incr()
43        -- Added mp_log_u32()
44        -- Improved prime-checking
45        -- Improved Toom-Cook multiplication
46        -- Removed the LTM book (`make docs` now builds the user manual)
49 Jan 28th, 2019
50 v1.1.0
51        -- Christoph Zurnieden contributed FIPS 186.4 compliant
52           prime-checking (PR #113), several other fixes and a load of documentation
53        -- Daniel Mendler provided two's-complement functions (PR #124)
54           and mp_{set,get}_double() (PR #123)
55        -- Francois Perrad took care of linting the sources, provided all fixes and
56           a astylerc to auto-format the sources.
57        -- A bunch of patches by Kevin B Kenny have been back-ported from TCL
58        -- Jan Nijtmans provided the patches to `const`ify all API
59           function arguments (also from TCL)
60        -- mp_rand() has now several native random provider implementations
61           and doesn't rely on `rand()` anymore
62        -- Karel Miko provided fixes when building for MS Windows
63           and re-worked the makefile generating process
64        -- The entire environment and build logic has been extended and improved
65           regarding auto-detection of platforms, libtool and a lot more
66        -- Prevent some potential BOF cases
67        -- Improved/fixed mp_lshd() and mp_invmod()
68        -- A load more bugs were fixed by various contributors
71 Aug 29th, 2017
72 v1.0.1
73        -- Dmitry Kovalenko provided fixes to mp_add_d() and mp_init_copy()
74        -- Matt Johnston contributed some improvements to mp_div_2d(),
75           mp_exptmod_fast(), mp_mod() and mp_mulmod()
76        -- Julien Nabet provided a fix to the error handling in mp_init_multi()
77        -- Ben Gardner provided a fix regarding usage of reserved keywords
78        -- Fixed mp_rand() to fill the correct number of bits
79        -- Fixed mp_invmod()
80        -- Use the same 64-bit detection code as in libtomcrypt
81        -- Correct usage of DESTDIR, PREFIX, etc. when installing the library
82        -- Francois Perrad updated all the perl scripts to an actual perl version
85 Feb 5th, 2016
86 v1.0
87        -- Bump to 1.0
88        -- Dirkjan Bussink provided a faster version of mp_expt_d()
89        -- Moritz Lenz contributed a fix to mp_mod()
90           and provided mp_get_long() and mp_set_long()
91        -- Fixed bugs in mp_read_radix(), mp_radix_size
92           Thanks to shameister, Gerhard R,
93        -- Christopher Brown provided mp_export() and mp_import()
94        -- Improvements in the code of mp_init_copy()
95           Thanks to ramkumarkoppu,
96        -- lomereiter provided mp_balance_mul()
97        -- Alexander Boström from the heimdal project contributed patches to
98           mp_prime_next_prime() and mp_invmod() and added a mp_isneg() macro
99        -- Fix build issues for Linux x32 ABI
100        -- Added mp_get_long_long() and mp_set_long_long()
101        -- Carlin provided a patch to use arc4random() instead of rand()
102           on platforms where it is supported
103        -- Karel Miko provided mp_sqrtmod_prime()
106 July 23rd, 2010
107 v0.42.0
108        -- Fix for mp_prime_next_prime() bug when checking generated prime
109        -- allow mp_shrink to shrink initialized, but empty MPI's
110        -- Added project and solution files for Visual Studio 2005 and Visual Studio 2008.
112 March 10th, 2007
113 v0.41  -- Wolfgang Ehrhardt suggested a quick fix to mp_div_d() which makes the detection of powers of two quicker.
114        -- [CRI] Added libtommath.dsp for Visual C++ users.
116 December 24th, 2006
117 v0.40  -- Updated makefile to properly support LIBNAME
118        -- Fixed bug in fast_s_mp_mul_high_digs() which overflowed (line 83), thanks Valgrind!
120 April 4th, 2006
121 v0.39  -- Jim Wigginton pointed out my Montgomery examples in figures 6.4 and 6.6 were off by one, k should be 9 not 8
122        -- Bruce Guenter suggested I use --tag=CC for libtool builds where the compiler may think it's C++.
123        -- "mm" from sci.crypt pointed out that my mp_gcd was sub-optimal (I also updated and corrected the book)
124        -- updated some of the @@ tags in tommath.src to reflect source changes.
125        -- updated email and url info in all source files
127 Jan 26th, 2006
128 v0.38  -- broken makefile.shared fixed
129        -- removed some carry stores that were not required [updated text]
131 November 18th, 2005
132 v0.37  -- [Don Porter] reported on a TCL list [HEY SEND ME BUGREPORTS ALREADY!!!] that mp_add_d() would compute -0 with some inputs.  Fixed.
133        -- [rinick@gmail.com] reported the makefile.bcc was messed up.  Fixed.
134        -- [Kevin Kenny] reported some issues with mp_toradix_n().  Now it doesn't require a min of 3 chars of output.
135        -- Made the make command renamable.  Wee
137 August 1st, 2005
138 v0.36  -- LTM_PRIME_2MSB_ON was fixed and the "OFF" flag was removed.
139        -- [Peter LaDow] found a typo in the XREALLOC macro
140        -- [Peter LaDow] pointed out that mp_read_(un)signed_bin should have "const" on the input
141        -- Ported LTC patch to fix the prime_random_ex() function to get the bitsize correct [and the maskOR flags]
142        -- Kevin Kenny pointed out a stray //
143        -- David Hulton pointed out a typo in the textbook [mp_montgomery_setup() pseudo-code]
144        -- Neal Hamilton (Elliptic Semiconductor) pointed out that my Karatsuba notation was backwards and that I could use
145           unsigned operations in the routine.
146        -- Paul Schmidt pointed out a linking error in mp_exptmod() when BN_S_MP_EXPTMOD_C is undefined (and another for read_radix)
147        -- Updated makefiles to be way more flexible
149 March 12th, 2005
150 v0.35  -- Stupid XOR function missing line again... oops.
151        -- Fixed bug in invmod not handling negative inputs correctly [Wolfgang Ehrhardt]
152        -- Made exteuclid always give positive u3 output...[ Wolfgang Ehrhardt ]
153        -- [Wolfgang Ehrhardt] Suggested a fix for mp_reduce() which avoided underruns.  ;-)
154        -- mp_rand() would emit one too many digits and it was possible to get a 0 out of it ... oops
155        -- Added montgomery to the testing to make sure it handles 1..10 digit moduli correctly
156        -- Fixed bug in comba that would lead to possible erroneous outputs when "pa < digs"
157        -- Fixed bug in mp_toradix_size for "0" [Kevin Kenny]
158        -- Updated chapters 1-5 of the textbook ;-) It now talks about the new comba code!
160 February 12th, 2005
161 v0.34  -- Fixed two more small errors in mp_prime_random_ex()
162        -- Fixed overflow in mp_mul_d() [Kevin Kenny]
163        -- Added mp_to_(un)signed_bin_n() functions which do bounds checking for ya [and report the size]
164        -- Added "large" diminished radix support.  Speeds up things like DSA where the moduli is of the form 2^k - P for some P < 2^(k/2) or so
165           Actually is faster than Montgomery on my AMD64 (and probably much faster on a P4)
166        -- Updated the manual a bit
167        -- Ok so I haven't done the textbook work yet... My current freelance gig has landed me in France till the
168           end of Feb/05.  Once I get back I'll have tons of free time and I plan to go to town on the book.
169           As of this release the API will freeze.  At least until the book catches up with all the changes.  I welcome
170           bug reports but new algorithms will have to wait.
172 December 23rd, 2004
173 v0.33  -- Fixed "small" variant for mp_div() which would munge with negative dividends...
174        -- Fixed bug in mp_prime_random_ex() which would set the most significant byte to zero when
175           no special flags were set
176        -- Fixed overflow [minor] bug in fast_s_mp_sqr()
177        -- Made the makefiles easier to configure the group/user that ltm will install as
178        -- Fixed "final carry" bug in comba multipliers. (Volkan Ceylan)
179        -- Matt Johnston pointed out a missing semi-colon in mp_exptmod
181 October 29th, 2004
182 v0.32  -- Added "makefile.shared" for shared object support
183        -- Added more to the build options/configs in the manual
184        -- Started the Depends framework, wrote dep.pl to scan deps and
185           produce "callgraph.txt" ;-)
186        -- Wrote SC_RSA_1 which will enable close to the minimum required to perform
187           RSA on 32-bit [or 64-bit] platforms with LibTomCrypt
188        -- Merged in the small/slower mp_div replacement.  You can now toggle which
189           you want to use as your mp_div() at build time.  Saves roughly 8KB or so.
190        -- Renamed a few files and changed some comments to make depends system work better.
191           (No changes to function names)
192        -- Merged in new Combas that perform 2 reads per inner loop instead of the older
193           3reads/2writes per inner loop of the old code.  Really though if you want speed
194           learn to use TomsFastMath ;-)
196 August 9th, 2004
197 v0.31  -- "profiled" builds now :-) new timings for Intel Northwoods
198        -- Added "pretty" build target
199        -- Update mp_init() to actually assign 0's instead of relying on calloc()
200        -- "Wolfgang Ehrhardt" <Wolfgang.Ehrhardt@munich.netsurf.de> found a bug in mp_mul() where if
201           you multiply a negative by zero you get negative zero as the result.  Oops.
202        -- J Harper from PeerSec let me toy with his AMD64 and I got 60-bit digits working properly
203           [this also means that I fixed a bug where if sizeof(int) < sizeof(mp_digit) it would bug]
205 April 11th, 2004
206 v0.30  -- Added "mp_toradix_n" which stores upto "n-1" least significant digits of an mp_int
207        -- Johan Lindh sent a patch so MSVC wouldn't whine about redefining malloc [in weird dll modes]
208        -- Henrik Goldman spotted a missing OPT_CAST in mp_fwrite()
209        -- Tuned tommath.h so that when MP_LOW_MEM is defined MP_PREC shall be reduced.
210           [I also allow MP_PREC to be externally defined now]
211        -- Sped up mp_cnt_lsb() by using a 4x4 table [e.g. 4x speedup]
212        -- Added mp_prime_random_ex() which is a more versatile prime generator accurate to
213           exact bit lengths (unlike the deprecated but still available mp_prime_random() which
214           is only accurate to byte lengths).  See the new LTM_PRIME_* flags ;-)
215        -- Alex Polushin contributed an optimized mp_sqrt() as well as mp_get_int() and mp_is_square().
216           I've cleaned them all up to be a little more consistent [along with one bug fix] for this release.
217        -- Added mp_init_set and mp_init_set_int to initialize and set small constants with one function
218           call.
219        -- Removed /etclib directory [um LibTomPoly deprecates this].
220        -- Fixed mp_mod() so the sign of the result agrees with the sign of the modulus.
221        ++ N.B.  My semester is almost up so expect updates to the textbook to be posted to the libtomcrypt.org
222           website.
224 Jan 25th, 2004
225 v0.29  ++ Note: "Henrik" from the v0.28 changelog refers to Henrik Goldman ;-)
226        -- Added fix to mp_shrink to prevent a realloc when used == 0 [e.g. realloc zero bytes???]
227        -- Made the mp_prime_rabin_miller_trials() function internal table smaller and also
228           set the minimum number of tests to two (sounds a bit safer).
229        -- Added a mp_exteuclid() which computes the extended euclidean algorithm.
230        -- Fixed a memory leak in s_mp_exptmod() [called when Barrett reduction is to be used] which would arise
231           if a multiplication or subsequent reduction failed [would not free the temp result].
232        -- Made an API change to mp_radix_size().  It now returns an error code and stores the required size
233           through an "int star" passed to it.
235 Dec 24th, 2003
236 v0.28  -- Henrik Goldman suggested I add casts to the montomgery code [stores into mu...] so compilers wouldn't
237           spew [erroneous] diagnostics... fixed.
238        -- Henrik Goldman also spotted two typos.  One in mp_radix_size() and another in mp_toradix().
239        -- Added fix to mp_shrink() to avoid a memory leak.
240        -- Added mp_prime_random() which requires a callback to make truly random primes of a given nature
241           (idea from chat with Niels Ferguson at Crypto'03)
242        -- Picked up a second wind.  I'm filled with Gooo.  Mission Gooo!
243        -- Removed divisions from mp_reduce_is_2k()
244        -- Sped up mp_div_d() [general case] to use only one division per digit instead of two.
245        -- Added the heap macros from LTC to LTM.  Now you can easily [by editing four lines of tommath.h]
246           change the name of the heap functions used in LTM [also compatible with LTC via MPI mode]
247        -- Added bn_prime_rabin_miller_trials() which gives the number of Rabin-Miller trials to achieve
248           a failure rate of less than 2^-96
249        -- fixed bug in fast_mp_invmod().  The initial testing logic was wrong.  An invalid input is not when
250           "a" and "b" are even it's when "b" is even [the algo is for odd moduli only].
251        -- Started a new manual [finally].  It is incomplete and will be finished as time goes on.  I had to stop
252           adding full demos around half way in chapter three so I could at least get a good portion of the
253           manual done.   If you really need help using the library you can always email me!
254        -- My Textbook is now included as part of the package [all Public Domain]
256 Sept 19th, 2003
257 v0.27  -- Removed changes.txt~ which was made by accident since "kate" decided it was
258           a good time to re-enable backups... [kde is fun!]
259        -- In mp_grow() "a->dp" is not overwritten by realloc call [re: memory leak]
260           Now if mp_grow() fails the mp_int is still valid and can be cleared via
261           mp_clear() to reclaim the memory.
262        -- Henrik Goldman found a buffer overflow bug in mp_add_d().  Fixed.
263        -- Cleaned up mp_mul_d() to be much easier to read and follow.
265 Aug 29th, 2003
266 v0.26  -- Fixed typo that caused warning with GCC 3.2
267        -- Martin Marcel noticed a bug in mp_neg() that allowed negative zeroes.
268           Also, Martin is the fellow who noted the bugs in mp_gcd() of 0.24/0.25.
269        -- Martin Marcel noticed an optimization [and slight bug] in mp_lcm().
270        -- Added fix to mp_read_unsigned_bin to prevent a buffer overflow.
271        -- Beefed up the comments in the baseline multipliers [and montgomery]
272        -- Added "mont" demo to the makefile.msvc in etc/
273        -- Optimized sign compares in mp_cmp from 4 to 2 cases.
275 Aug 4th, 2003
276 v0.25  -- Fix to mp_gcd again... oops (0,-a) == (-a, 0) == a
277        -- Fix to mp_clear which didn't reset the sign  [Greg Rose]
278        -- Added mp_error_to_string() to convert return codes to strings.  [Greg Rose]
279        -- Optimized fast_mp_invmod() to do the test for invalid inputs [both even]
280           first so temps don't have to be initialized if it's going to fail.
281        -- Optimized mp_gcd() by removing mp_div_2d calls for when one of the inputs
282           is odd.
283        -- Tons of new comments, some indentation fixups, etc.
284        -- mp_jacobi() returns MP_VAL if the modulus is less than or equal to zero.
285        -- fixed two typos in the header of each file :-)
286        -- LibTomMath is officially Public Domain [see LICENSE]
288 July 15th, 2003
289 v0.24  -- Optimized mp_add_d and mp_sub_d to not allocate temporary variables
290        -- Fixed mp_gcd() so the gcd of 0,0 is 0.  Allows the gcd operation to be chained
291           e.g. (0,0,a) == a [instead of 1]
292        -- Should be one of the last release for a while.  Working on LibTomMath book now.
293        -- optimized the pprime demo [/etc/pprime.c] to first make a huge table of single
294           digit primes then it reads them randomly instead of randomly choosing/testing single
295           digit primes.
297 July 12th, 2003
298 v0.23  -- Optimized mp_prime_next_prime() to not use mp_mod [via is_divisible()] in each
299           iteration.  Instead now a smaller table is kept of the residues which can be updated
300           without division.
301        -- Fixed a bug in next_prime() where an input of zero would be treated as odd and
302           have two added to it [to move to the next odd].
303        -- fixed a bug in prime_fermat() and prime_miller_rabin() which allowed the base
304           to be negative, zero or one.  Normally the test is only valid if the base is
305           greater than one.
306        -- changed the next_prime() prototype to accept a new parameter "bbs_style" which
307           will find the next prime congruent to 3 mod 4.  The default [bbs_style==0] will
308           make primes which are either congruent to 1 or 3 mod 4.
309        -- fixed mp_read_unsigned_bin() so that it doesn't include both code for
310           the case DIGIT_BIT < 8 and >= 8
311        -- optimized div_d() to easy out on division by 1 [or if a == 0] and use
312           logical shifts if the divisor is a power of two.
313        -- the default DIGIT_BIT type was not int for non-default builds.  Fixed.
315 July 2nd, 2003
316 v0.22  -- Fixed up mp_invmod so the result is properly in range now [was always congruent to the inverse...]
317        -- Fixed up s_mp_exptmod and mp_exptmod_fast so the lower half of the pre-computed table isn't allocated
318           which makes the algorithm use half as much ram.
319        -- Fixed the install script not to make the book :-) [which isn't included anyways]
320        -- added mp_cnt_lsb() which counts how many of the lsbs are zero
321        -- optimized mp_gcd() to use the new mp_cnt_lsb() to replace multiple divisions by two by a single division.
322        -- applied similar optimization to mp_prime_miller_rabin().
323        -- Fixed a bug in both mp_invmod() and fast_mp_invmod() which tested for odd
324           via "mp_iseven() == 0" which is not valid [since zero is not even either].
326 June 19th, 2003
327 v0.21  -- Fixed bug in mp_mul_d which would not handle sign correctly [would not always forward it]
328        -- Removed the #line lines from gen.pl [was in violation of ISO C]
330 June 8th, 2003
331 v0.20  -- Removed the book from the package.  Added the TDCAL license document.
332        -- This release is officially pure-bred TDCAL again [last officially TDCAL based release was v0.16]
334 June 6th, 2003
335 v0.19  -- Fixed a bug in mp_montgomery_reduce() which was introduced when I tweaked mp_rshd() in the previous release.
336           Essentially the digits were not trimmed before the compare which cause a subtraction to occur all the time.
337        -- Fixed up etc/tune.c a bit to stop testing new cutoffs after 16 failures [to find more optimal points].
338           Brute force ho!
341 May 29th, 2003
342 v0.18  -- Fixed a bug in s_mp_sqr which would handle carries properly just not very elegantly.
343           (e.g. correct result, just bad looking code)
344        -- Fixed bug in mp_sqr which still had a 512 constant instead of MP_WARRAY
345        -- Added Toom-Cook multipliers [needs tuning!]
346        -- Added efficient divide by 3 algorithm mp_div_3
347        -- Re-wrote mp_div_d to be faster than calling mp_div
348        -- Added in a donated BCC makefile and a single page LTM poster (ahalhabsi@sbcglobal.net)
349        -- Added mp_reduce_2k which reduces an input modulo n = 2**p - k for any single digit k
350        -- Made the exptmod system be aware of the 2k reduction algorithms.
351        -- Rewrote mp_dr_reduce to be smaller, simpler and easier to understand.
353 May 17th, 2003
354 v0.17  -- Benjamin Goldberg submitted optimized mp_add and mp_sub routines.  A new gen.pl as well
355           as several smaller suggestions.  Thanks!
356        -- removed call to mp_cmp in inner loop of mp_div and put mp_cmp_mag in its place :-)
357        -- Fixed bug in mp_exptmod that would cause it to fail for odd moduli when DIGIT_BIT != 28
358        -- mp_exptmod now also returns errors if the modulus is negative and will handle negative exponents
359        -- mp_prime_is_prime will now return true if the input is one of the primes in the prime table
360        -- Damian M Gryski (dgryski@uwaterloo.ca) found a index out of bounds error in the
361           mp_fast_s_mp_mul_high_digs function which didn't come up before.  (fixed)
362        -- Refactored the DR reduction code so there is only one function per file.
363        -- Fixed bug in the mp_mul() which would erroneously avoid the faster multiplier [comba] when it was
364           allowed.  The bug would not cause the incorrect value to be produced just less efficient (fixed)
365        -- Fixed similar bug in the Montgomery reduction code.
366        -- Added tons of (mp_digit) casts so the 7/15/28/31 bit digit code will work flawlessly out of the box.
367           Also added limited support for 64-bit machines with a 60-bit digit.  Both thanks to Tom Wu (tom@arcot.com)
368        -- Added new comments here and there, cleaned up some code [style stuff]
369        -- Fixed a lingering typo in mp_exptmod* that would set bitcnt to zero then one.  Very silly stuff :-)
370        -- Fixed up mp_exptmod_fast so it would set "redux" to the comba Montgomery reduction if allowed.  This
371           saves quite a few calls and if statements.
372        -- Added etc/mont.c a test of the Montgomery reduction [assuming all else works :-| ]
373        -- Fixed up etc/tune.c to use a wider test range [more appropriate] also added a x86 based addition which
374           uses RDTSC for high precision timing.
375        -- Updated demo/demo.c to remove MPI stuff [won't work anyways], made the tests run for 2 seconds each so its
376           not so insanely slow.  Also made the output space delimited [and fixed up various errors]
377        -- Added logs directory, logs/graph.dem which will use gnuplot to make a series of PNG files
378           that go with the pre-made index.html.  You have to build [via make timing] and run ltmtest first in the
379           root of the package.
380        -- Fixed a bug in mp_sub and mp_add where "-a - -a" or "-a + a" would produce -0 as the result [obviously invalid].
381        -- Fixed a bug in mp_rshd.  If the count == a.used it should zero/return [instead of shifting]
382        -- Fixed a "off-by-one" bug in mp_mul2d.  The initial size check on alloc would be off by one if the residue
383           shifting caused a carry.
384        -- Fixed a bug where s_mp_mul_digs() would not call the Comba based routine if allowed.  This made Barrett reduction
385           slower than it had to be.
387 Mar 29th, 2003
388 v0.16  -- Sped up mp_div by making normalization one shift call
389        -- Sped up mp_mul_2d/mp_div_2d by aliasing pointers :-)
390        -- Cleaned up mp_gcd to use the macros for odd/even detection
391        -- Added comments here and there, mostly there but occasionally here too.
393 Mar 22nd, 2003
394 v0.15  -- Added series of prime testing routines to lib
395        -- Fixed up etc/tune.c
396        -- Added DR reduction algorithm
397        -- Beefed up the manual more.
398        -- Fixed up demo/demo.c so it doesn't have so many warnings and it does the full series of
399           tests
400        -- Added "pre-gen" directory which will hold a "gen.pl"'ed copy of the entire lib [done at
401           zipup time so its always the latest]
402        -- Added conditional casts for C++ users [boo!]
404 Mar 15th, 2003
405 v0.14  -- Tons of manual updates
406        -- cleaned up the directory
407        -- added MSVC makefiles
408        -- source changes [that I don't recall]
409        -- Fixed up the lshd/rshd code to use pointer aliasing
410        -- Fixed up the mul_2d and div_2d to not call rshd/lshd unless needed
411        -- Fixed up etc/tune.c a tad
412        -- fixed up demo/demo.c to output comma-delimited results of timing
413           also fixed up timing demo to use a finer granularity for various functions
414        -- fixed up demo/demo.c testing to pause during testing so my Duron won't catch on fire
415           [stays around 31-35C during testing :-)]
417 Feb 13th, 2003
418 v0.13  -- tons of minor speed-ups in low level add, sub, mul_2 and div_2 which propagate
419           to other functions like mp_invmod, mp_div, etc...
420        -- Sped up mp_exptmod_fast by using new code to find R mod m [e.g. B^n mod m]
421        -- minor fixes
423 Jan 17th, 2003
424 v0.12  -- re-wrote the majority of the makefile so its more portable and will
425           install via "make install" on most *nix platforms
426        -- Re-packaged all the source as separate files.  Means the library a single
427           file package any more.  Instead of just adding "bn.c" you have to add
428           libtommath.a
429        -- Renamed "bn.h" to "tommath.h"
430        -- Changes to the manual to reflect all of this
431        -- Used GNU Indent to clean up the source
433 Jan 15th, 2003
434 v0.11  -- More subtle fixes
435        -- Moved to gentoo linux [hurrah!] so made *nix specific fixes to the make process
436        -- Sped up the montgomery reduction code quite a bit
437        -- fixed up demo so when building timing for the x86 it assumes ELF format now
439 Jan 9th, 2003
440 v0.10  -- Pekka Riikonen suggested fixes to the radix conversion code.
441        -- Added baseline montgomery and comba montgomery reductions, sped up exptmods
442           [to a point, see bn.h for MONTGOMERY_EXPT_CUTOFF]
444 Jan 6th, 2003
445 v0.09  -- Updated the manual to reflect recent changes.  :-)
446        -- Added Jacobi function (mp_jacobi) to supplement the number theory side of the lib
447        -- Added a Mersenne prime finder demo in ./etc/mersenne.c
449 Jan 2nd, 2003
450 v0.08  -- Sped up the multipliers by moving the inner loop variables into a smaller scope
451        -- Corrected a bunch of small "warnings"
452        -- Added more comments
453        -- Made "mtest" be able to use /dev/random, /dev/urandom or stdin for RNG data
454        -- Corrected some bugs where error messages were potentially ignored
455        -- add etc/pprime.c program which makes numbers which are provably prime.
457 Jan 1st, 2003
458 v0.07  -- Removed a lot of heap operations from core functions to speed them up
459        -- Added a root finding function [and mp_sqrt macro like from MPI]
460        -- Added more to manual
462 Dec 31st, 2002
463 v0.06  -- Sped up the s_mp_add, s_mp_sub which inturn sped up mp_invmod, mp_exptmod, etc...
464        -- Cleaned up the header a bit more
466 Dec 30th, 2002
467 v0.05  -- Builds with MSVC out of the box
468        -- Fixed a bug in mp_invmod w.r.t. even moduli
469        -- Made mp_toradix and mp_read_radix use char instead of unsigned char arrays
470        -- Fixed up exptmod to use fewer multiplications
471        -- Fixed up mp_init_size to use only one heap operation
472           -- Note there is a slight "off-by-one" bug in the library somewhere
473              without the padding (see the source for comment) the library
474              crashes in libtomcrypt.  Anyways a reasonable workaround is to pad the
475              numbers which will always correct it since as the numbers grow the padding
476              will still be beyond the end of the number
477        -- Added more to the manual
479 Dec 29th, 2002
480 v0.04  -- Fixed a memory leak in mp_to_unsigned_bin
481        -- optimized invmod code
482        -- Fixed bug in mp_div
483        -- use exchange instead of copy for results
484        -- added a bit more to the manual
486 Dec 27th, 2002
487 v0.03  -- Sped up s_mp_mul_high_digs by not computing the carries of the lower digits
488        -- Fixed a bug where mp_set_int wouldn't zero the value first and set the used member.
489        -- fixed a bug in s_mp_mul_high_digs where the limit placed on the result digits was not calculated properly
490        -- fixed bugs in add/sub/mul/sqr_mod functions where if the modulus and dest were the same it wouldn't work
491        -- fixed a bug in mp_mod and mp_mod_d concerning negative inputs
492        -- mp_mul_d didn't preserve sign
493        -- Many many many many fixes
494        -- Works in LibTomCrypt now :-)
495        -- Added iterations to the timing demos... more accurate.
496        -- Tom needs a job.
498 Dec 26th, 2002
499 v0.02  -- Fixed a few "slips" in the manual.  This is "LibTomMath" afterall :-)
500        -- Added mp_cmp_mag, mp_neg, mp_abs and mp_radix_size that were missing.
501        -- Sped up the fast [comba] multipliers more [yahoo!]
503 Dec 25th,2002
504 v0.01  -- Initial release.  Gimme a break.
505        -- Todo list,
506            add details to manual [e.g. algorithms]
507            more comments in code
508            example programs