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
  POLY2XY.H    -  Bivariate Polynomials - Class Definition
  POLY2XY.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
  RSA.C        - quick start RSA application

  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
  ECN4.H       - Elliptic curves over Fp4 - Header file
  ECN4.CPP     - Elliptic curves over Fp4 - Implementation file
  ZZN2.H       - Fp2 arithmetic - Header file
  ZZN2.CPP     - Fp2 arithmetic - Implementation file
  ZZN4.H       - Fp4 arithmetic - Header file
  ZZN4.CPP     - Fp4 arithmetic - Implementation file
  ZZN8.H       - Fp8 arithmetic - Header file
  ZZN8.CPP     - Fp8 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
  FREEMAN.CPP  - Program to generate k=10 Freeman curves
  FOLKLORE.CPP - program to create pairing-friendly non-SS curves
  IRRED.CPP    - Finds irreducible polynomial - Experimental!
  AKE.TXT      - Some explanation for these programs. 
  AKE6.CPP     - Authenticated Key Exchange, k=6  - Experimental!
  AKE2.CPP     - Same as above, but ZZn2 based
  AKE2SS.CPP   - Same as above, but uses a supersingular curve
  AKE4.CPP     - Same as above, but ZZn4 based
  AKEW4.CPP    - Variation on the above
  AKE8.CPP     - Same as above, but ZZn8 based
  AKEW8.CPP    - Variation on the above
  K2.ECS       - Non-supersingular curve, k=2 
  K2SS.ECS     - Supersingular curve, k=2
  K4.ECS       - Non-supersingular curve, k=4 
  K8.ECS       - Non-supersingular curve, k=8 
  WENG.ECS     - Non-supersingular curve, k=8
  DL.CPP       - Duursma-Lee Char 2 pairings
  DL2.CPP      - Trucnated-loop Barreto-Galbraith-O'hEigearaigh-Scott faster char 2 pairings
  BANDW.CPP    - Brezing & Weng curves
  NSS3.CPP     - Faster k=2 key exchange program
  PAIRINGS.TXT - Details of pairing-based resources

  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
  FLOATING.H   -    C++ header for 'float' numbers
  ZZN.H        -    C++ header for 'big' numbers mod n
  CRT.H        -    C++ header for chinese remainder thereom
  ECN.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
  NIST163/233  -    Parameter files for standard 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

  These files (ONLY!!) are FREEWARE, and may be freely copied 
  and distributed, unmodified. Copyright remains with Shamus Software.