📄 readme.txt
字号:
IMPORTANT! See UPDATE.DOC for latest changes
The distribution media contains the following files
README.TXT - This file
FIRST.TXT - Read this next
MSVISUAL.TXT - Microsoft Visual C++ quick-start instructions
BORLAND.TXT - Borland C quick-start instructions
ARM.TXT - ARM processor advice
SPARC.TXT - SPARC processor advise
LINUX.TXT - Some advice for Linux users
MANUAL.DOC - The Manual - read it!
PROBLEMS.TXT - Known problems with MIRACL
UPDATE.TXT - MIRACL Update History
KCMCOMBA.TXT - Using super-fast techniques
MAKEMCS.TXT - How to create your own .mcs file
DOUBLE.TXT - Using a double underlying type
CONFIG.C - Program to automatically generate a mirdef.h file
MEX.C - Program to insert fast macros into mrcomba.c/mrkcm.c
In the subdirectory SOURCE
MRMULDV.ANY - Contains assembly language versions of muldiv,muldvm,
muldvd and muldvd2
MRMULDV.S - Version of the above for Linux i386 GCC
MRMULDV.C - Version of the above for Win32
MRMULDV.CCC - Standard C version
MRMULDV.GPP - Version of the above for DJGPP GCC
MR*.C - MIRACL library source files
MRCOMBA.TPL - Template file for fast Comba method
MRKCM.TPL - Template file for fast KCM method
C.MCS - C macros for use with above
C1.MCS - Alternate C macros
MS86.MCS - Microsoft/Borland 80*86/Pentium macros for use with above
GCC386.MCS - GCC compiler compatible Pentium macros
ARM.MCS - ARM processor macros
SPARC32.MCS - 32-bit Sparc processor macros
SPARC64.MCS - 64-bit Sparc processor macros
BMARK.C - Benchmark program for Public Key methods
IMRATIO.C - Benchmark program. Calculates S/M, I/M and J/M ratios
MERSENNE.C - Mersenne primes
FACT.C - Factorials
BRUTE.C - Brute-force factorisation
BRENT.C - Brent-pollard factoring
BRENT_MT.C - Example of generic Multi-Threading
HAIL.C - Hailstone numbers
PALIN.C - Palindromic numbers
GENKEY.C - Generate Public and Private keys
ENCODE.C - Encode using RSA method
DECODE.C - Decode using RSA method
ENCIPH.C - Encipher using Probabalistic method
DECIPH.C - Decipher using Probabalistic method
PK-DEMO.C - Demo of RSA/El Gamal/Diffie-Hellman/Elliptic Curve...
IDENTITY.C - ID based key exchange program
HILBERT.C - Solve special system of equations
SAMPLE.C - Example of Flash arithmetic
ROOTS.C - Square roots
POLLARD.C - Pollard's factoring method
WILLIAMS.C - William's factoring method
LENSTRA.C - Lenstra's factoring method
QSIEVE.C - The Quadratic Sieve
RATCALC.C - Rational Scientific Calculator
FACTOR.C - Factoring Program source
KANGAROO.C - Pollards Lambda method for discrete logs
INDEX.C - Pollards rho method for discrete logs
GENPRIME.C - Generates prime for above
LIMLEE.C - Lim-Lee prime generation
DSSETUP.C - Digital Signature Standard setup program
DSSGEN.C - Digital Signature Standard key generator program
DSSIGN.C - Digital Signature Standard signature program
DSSVER.C - Digital Signature Standard verification program
ECSGEN.C - DSS (Elliptic Curve GF(p) variation) key generator program
ECSIGN.C - DSS (Elliptic Curve GF(p) variation) signature program
ECSVER.C - DSS (Elliptic Curve GF(p) variation) verification program
ECSGEN2.C - DSS (Elliptic Curve GF(2^m) variation) key generator program
ECSIGN2.C - DSS (Elliptic Curve GF(2^m) variation) signature program
ECSVER2.C - DSS (Elliptic Curve GF(2^m) variation) verification program
BRICK.C - Brickell's method for fast exponentiation
EBRICK.C - Same for GF(p) Elliptic Curves
EBRICK2.C - Same for GF(2^m) Elliptic Curves
BIG.CPP - Big function implementations
MONTY.CPP - ZZn function implementations
ELLIPTIC.CPP - ECn function implementations
EC2.CPP - EC2 function implementations
GF2M.CPP - GF(2^m) function implementations
CRT.CPP - Crt function implementations
FLASH.CPP - Flash function implementations
PAL_ENC.CPP - Paillier Homomorphic Encryption Program
PAL_DEC.CPP - Paillier Homomorphic Decryption Program
THREADWN.CPP - Example of Windows Multi-threading
THREADUX.CPP - Example of Unix Multi-Threading
FACT.CPP - Example C++ source (uses BIG.H)
HAIL.CPP - " "
PALIN.CPP - " "
BRUTE.CPP - " "
MERSENNE.CPP - " "
QSIEVE.CPP - " "
GENKEY.CPP - " "
ENCODE.CPP - " "
DECODE.CPP - " "
ENCIPH.CPP - " "
DECIPH.CPP - " "
PK-DEMO.CPP - " "
LIMLEE.CPP - " "
DSSETUP.CPP - " "
DSSGEN.CPP - " "
DSSIGN.CPP - " "
DSSVER.CPP - " "
KANGAROO.CPP - " "
INDEX.CPP - " "
GENPRIME.CPP - " "
BRICK.CPP - " "
EBRICK.CPP - Example C++ source (uses ELLIPTIC.H)
ECSGEN.CPP - " "
ECSIGN.CPP - " "
ECSVER.CPP - " "
EBRICK2.CPP - Example C++ source (uses EC2.H)
ECSGEN2.CPP - " "
ECSIGN2.CPP - " "
ECSVER2.CPP - " "
POLLARD.CPP - Example C++ source (uses MONTY.H)
WILLIAMS.CPP - " "
LENSTRA.CPP - " "
BRENT.CPP - " "
SAMPLE.CPP - Example C++ source (uses FLASH.H)
ROOTS.CPP - " "
HILBERT.CPP - " "
Note how readable the C++ versions of the example programs look.
In the subdirectory SOURCE/CURVE
CM.CPP - Complex Multiplication - creates elliptic curves
POLY.H - Polynomial Class definition, elements from ZZn
POLY.CPP - Polynomial Arithmetic with ZZn coefficients
POLY2.H - Polynomial Class definition, elements from GF(2^m)
POLY2.CPP - Polynomial Arithmetic with GF(2^m) coefficients
FPOLY.H - Polynomial Class definition, flash elements
POLY.CPP - Polynomila arithmetic with flash coefficients
COMFLASH.H - Complex Flash class definition
COMFLASH.CPP - Complex Flash number arithmetic
CM.TXT - How to build the CM application
POLYMOD.H - Polynomials mod a Polynomial - Class Definition
POLYMOD.CPP - ZZn Polynomial arithmetic wrt a Polynomial Modulus
POLY2MOD.H - Polynomials mod a Polynomial - Class Definition
POLY2MOD.CPP - GF(2^m) Polynomial arithmetic wrt a Polynomial Modulus
TRANS.CPP - A simple utility to convert elliptic curve to Weierstrass
SCHOOF.CPP - Schoof's method for counting points on a GF(p) elliptic curve
SCHOOF2.CPP - Schoof's method for counting points on a GF(2^m) elliptic curve
SCHOOF.TXT - How to build the schoof Application
SCHOOF2.TXT - How to build the schoof2 Application
PS_BIG.H - Power series with Big coefficients - Class Definition
PS_BIG.CPP - Power Series Arithmetic
PS_ZZN.H - Power series with ZZN coefficients - Class Definition
PS_ZZN.CPP - Power Series Arithmetic
POLYXY.H - Bivariate Polynomials - Class Definition
POLYXY.CPP - Bivariate Polynomilas - Implementation
MUELLER.CPP - Program to generate Modular Polynomials
PROCESS.CPP - Program to process Modular Polynomials wrt a prime modulus
SEA.CPP - Schoof-Elkies-Atkin-Mueller algorithm
SEA.TXT - How to build the MUELLER/PROCESS/SEA applications
In the subdirectory SOURCE\P1363
P1363.H - P1363 Header File
P1363.C - P1363 implementation file
TEST1363.c - test driver for P1363 implementation
In the subdirectory SOURCE\IBE
IBE.TXT - Read this first
IBE_SET.CPP - Create IBE paramters, and master key
IBE_EXT.CPP - Extract a private key from the Identity
IBE_ENC.CPP - Encrypt a file using identity
IBE_DEC.CPP - Decrypt a file using the private key
IBE_DECP.CPP - Decrypt using precomputation
IBE_DECB.CPP - Decrypt using batching
IBE_ENCP.CPP - Demonstrate Encryption using precomputation
ECN2.H - Elliptic curves over Fp2 - Header file
ECN2.CPP - Elliptic curves over Fp2 - Implementation file
ZZN2.H - Fp2 arithmetic - Header file
ZZN2.CPP - Fp2 arithmetic - Implementation file
ECN6.H/.CPP - Elliptic curves over Fp6 - Experimental!
ZZN6.H/.CPP - Fp6 arithmetic - Experimental!
ZZN6.DAT - Precomputed data need for above
MNT.CPP - Program to generate MNT elliptic curves - Experimental!
MNT.ECS - Non-supersingular curve, k=6, created by CM from MNT output
IRRED.CPP - Finds irreducible polynomial - Experimental!
AKE6.CPP - Authenticated Key Exchange, k=6 - Experimental!
AKE2.CPP - Same as above, but ZZn2 based
K2.CPP - Non-supersingular curve, k=2
In the subdirectory INCLUDE
MIRDEF.H16 - Standard hardware specific header file for 16-bit computer
MIRDEF.H32 - Header file for full 32-bit Computer
MIRDEF.H - Same as above
MIRDEF.HPC - Header file for pseudo-32 bit computer
MIRDEF.HAF - Header file for 16 bit use of 32 bit computer
MIRDEF.HIO - Integer-Only 32-bit header file
MIRACL.H - Main MIRACL header
BIG.H - C++ header for 'big' numbers
FLASH.H - C++ header for 'flash' numbers
MONTY.H - C++ header for 'big' numbers mod n
CRT.H - C++ header for chinese remainder thereom
ELLIPTIC.H - C++ header for GF(p) Elliptic Curves
EC2.H - C++ header for GF(2^m) Elliptic Curves
GF2M.H - C++ header for GF(2^m)
BRICK.H - C++ header for Brickell's method
EBRICK.H - C++ header for Brickell's method (Elliptic Curve GF(p) version)
EBRICK2.H - C++ header for Brickell's method (Elliptic Curve GF(2^m) version)
In the subdirectory LIB
*DOIT.BAT - Batch files for constructing libraries and sample progs.
MIRACL.MAK - John Kennedy's UNIX make file
BC32.LIB - Borland C++ V5.5 32 bit flat memory model MIRACL library
MS32.LIB - Microsoft C 32 bit MIRACL library (for Win95/WinNT)
MIRACL.A - DJGPP GNU C MIRACL Library
If using 16-bit Borland C++ V5.5 then use BCLDOIT.BAT to build MIRACL.LIB
Then copy MIRDEF.H16 to MIRDEF.H, and you're in business. Use BCXDOIT.BAT to
build a library for use with MIRDEF.HPC, to provide pseudo 32-bit performance
from a 16-bit compiler. BC32.LIB is a true 32-bit flat model library for use
with MIRDEF.H32. It was compiled with the Borland 32 bit compiler BCC32.
Programs generated in this way require a DOS Extender program (e.g. Borland
Powerpack for DOS), or Win32, or a Windows '95/98/NT environment.
MS32.LIB is for use with the MicroSoft 32 bit compiler and MIRDEF.H32
(for use with Windows95/98 or WinNT).
Older versions of these compilers may also work with these precompiled
libraries (try it and see). If using another compiler then you must execute
an appropriate xxDOIT.BAT file to create the MIRACL library.
If a pre-compiled library is not available:-
(1) Determine which of mirdef.h32/mirdef.h16/mirdef.haf/mirdef.hpc is
suitable for you, and/or compile and run config.c to automatically
generate a suitable mirdef.h.
(2) If for performance reasons a non-portable version is to be built,
select suitable assembly language routines from mrmuldv.any, or
write them yourself (send us a copy!). Even better - produce a
,mcs file for the processor and use either the KCM or Comba method.
(3) Compile and link together the mr*.c components into an object library.
Also assemble and link in the assemble language component from
mrmuldv.any (if needed).
In the subdirectory EXE some precompiled example programs
FACT.EXE - Factorial program
ROOTS.EXE - Roots program
PK-DEMO.EXE - Public Key Demo program (32-bit)
ENCIPH.EXE - Enciphering program
DECIPH.EXE - Deciphering program
PUBLIC.KEY - Public key for use by enciphering program
PRIVATE.KEY - Private key for use by deciphering program
SECP160/192/224/521.ecs - Parameter files for some standard elliptic curves
In the sub-directory FREE some FREEWARE 32-bit IBM PC Command prompt
specific applications. CM.EXE is free as well, but omitted here for space
reasons.
READ.TXT - Read this first
RATCALC.EXE - Rational Calculator
FACTOR.EXE - General purpose Factoring Program (80386+ only)
For maximum speed this is compiled as a true 32-bit
and runs in a 32-bit DOS Window
SCHOOF.EXE - Plain vanilla Schoof Algorithm for counting points
on GF(p) Elliptic Curves
MUELLER.EXE }
MODPOL.EXE } Suite of programs to implement superior Schoof-Elkies-
PROCESS.EXE } Atkin algorithm for counting points on GF(p) curves
SEA.EXE }
These files (ONLY!!) are FREEWARE, and may be freely copied
and distributed, unmodified. Copyright remains with Shamus Software.
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -