home *** CD-ROM | disk | FTP | other *** search
/ The C Users' Group Library 1994 August / wc-cdrom-cusersgrouplibrary-1994-08.iso / vol_200 / 247_02 / readme.doc < prev    next >
Text File  |  1989-04-19  |  4KB  |  88 lines
  1.                               MIRACL 
  2.  
  3. Remember when as a naive young computer user,  you received  delivery  of 
  4. your brand new state-of-the-art micro;  remember your anticipation at the 
  5. prospect of the computer power now available at your fingertips; remember 
  6. recalling all those articles which promised that  "todays  microcomputers 
  7. are  as  powerful  as  yesterdays  mainframes".  Remember then slowly and 
  8. laboriously typing in your first program, to calculate, say,  100!  (i.e. 
  9. 100x99x98..x3x2x1) - a calculation unimaginable by hand.  
  10.  
  11.                        10 LET X=1
  12.                        20 FOR I=1 TO 100
  13.                        30 X=X*I
  14.                        40 NEXT I
  15.                        50 PRINT X
  16.                        60 END
  17.  
  18.                        RUN
  19.  
  20. After a few seconds the result appeared:-
  21.  
  22.                        Too big at line 30
  23.  
  24. Remember your disappointment.
  25.  
  26. Now try MIRACL.  Run the program 'fact' on the distribution diskette, and 
  27. type in 100. Theres your answer.  
  28.  
  29. Now  run the program 'roots',  and ask it to calculate the square root of 
  30. 2, that is 2 to the power of 1/2. Virtually instantly your computer comes 
  31. back with the value correct to 100+ decimal places. Now thats what I call 
  32. computing!  
  33.  
  34. Next  run the Public Key Cryptography program 'enciph'.  When it asks the 
  35. name of a file to be enciphered press return.  When it asks for an output 
  36. filename,  type  'FRED'  followed  by  return.  Now  type in any message, 
  37. finishing with CTRL Z (control  Z).  Your  message  has  been  thoroughly 
  38. enciphered in the file FRED.OKA (type it out and see).  Now run 'deciph', 
  39. and type in FRED.  Press return for the requested output  filename.  Your 
  40. original message appears on the screen.  
  41.  
  42. This type of encipherment,  based as it is on the difficulty of factoring 
  43. large numbers,  offers much greater security and  flexibility  than  more 
  44. traditional methods.  
  45.  
  46. A  useful  demonstration  of  the power of MIRACL is given by the program 
  47. RATCALC, a powerful scientific calculator - accurate to 36 decimal places 
  48. and with the unusual ability to handle fractions directly.  
  49.  
  50.  
  51.  
  52. GETTING STARTED
  53.  
  54. The complete source code for each module in the MIRACL library,  and  for 
  55. each  of the example programs is on this disk.  Each (except bnmuldv.any) 
  56. is written in Standard C, and should compile using any decent C compiler.  
  57. The batch files xxDOIT.xxx contain the commands used for the creation  of 
  58. a library file and the example programs for several popular computers and 
  59. compilers.   Print   out  and  examine  the  appropriate  file  for  your 
  60. configuration. 
  61.  
  62. Pre-compiled libraries for immediate use with certain  popular  compilers
  63. may be found on the second diskette: ready-to-run versions of  only  some
  64. of the example programs may be included, due to  lack  of  space  on  the
  65. distribution media.   
  66.  
  67. IMPORTANT!
  68.  
  69. To  create  a  library  you will need access to a compiler,  a linker,  a 
  70. librarian utility,  and  an  assembler  (optional).  Read  your  compiler 
  71. documentation  for further details.  The file bnmuldv.any, which contains
  72. many versions of the time-critical routine  'muldiv',  will  need  to  be 
  73. tailored for your configuration.  Copy it to a file named  bnmuldv.c  and 
  74. edit  this  file.  Read the manual carefully and the comments in mirdef.h 
  75. and bnmuldv.any for details.  
  76.  
  77. The main header file miracl.h may need to be edited if you use  an  older 
  78. type of C compiler,  which does not support the new ANSI extensions.  See 
  79. the comments at the beginning of miracl.h for details.  
  80.  
  81. The  file  mirdef.h may also need to be edited,  if you want to implement 
  82. the MIRACL library on a computer other than that originally specified.  
  83.  
  84. The  manual  is  on  disk,  in  manual1.doc  and  manual2.doc, and should
  85. be printed out on  a  dot-matrix  printer  which  recognises  the  IBM PC 
  86. extended character set.
  87.  
  88.