home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / FORTRAN / CODE3_4.ZIP / PCCODE.DOC < prev    next >
Encoding:
Text File  |  1986-12-01  |  7.9 KB  |  217 lines
  1.  
  2.    * * * * * * * * * * * * * * * * * * * * * * * * *
  3.    *                                               *
  4.    *  P C - C O D E 3     &      P C - C O D E 4   *
  5.    *                                               *
  6.    * * * * * * * * * * * * * * * * * * * * * * * * *
  7.  
  8.  
  9.  
  10.    v6.1/v6.2   April 1986    By Richard Nolen COLVARD
  11.  
  12.  
  13.    PC-CODE3 and PC-CODE4 are Portable Versions Specifically
  14.    for Generic MS-DOS and Xenix 5. They are written in a
  15.    strictly portable Microsoft FORTRAN-77 V3.30. The Object
  16.    code on these diskette(s) is compatiable with both MS-DOS
  17.    and Microsoft Xenix; meaning these program need NO recompiling
  18.    - they only needed to LINKED to the respective libraries.
  19.    As distributed they have been Linked for MS-DOS.
  20.  
  21.    It is a goal to generate only Portable Source Code in
  22.    universally Portable languages like FORTRAN and "C".
  23.    Most versions of Unix (copyright ATT) supply a FORTRAN
  24.    compiler usually called "F77".
  25.  
  26.    As an added side feature, the MS-DOS version will automatically
  27.    execute faster if the PC contains an Intel 8087 math co-processor.
  28.    If your PC doesnot - no matter - except that the programs will
  29.    run slower.
  30.  
  31.  
  32.    PC-CODE3 is a simplified version of PC-CODE2 (V1.53) and likewise
  33.    is intended for "Printable" textal data or Console input (CON:).
  34.  
  35.  
  36.    PC-CODE4 is a simplified version of PC-CODE1 (V1.53) and likewise
  37.    is intended for encoding Files as opposed to text.
  38.  
  39.  
  40.    PC-STAT3 is a simple statistical program by which the user may
  41.    do simple analysis of either a Plain Text FILE or a Coded FILE.
  42.    Basically, it does frequency counts that were previously embedded
  43.    features of PC-CODE1 & 2.
  44.  
  45.  
  46.    INSTALL3 is used to drive and configure PC-CODE3/PC-CODE4.
  47.    Many options that were specified repeatitively by questions
  48.    now are answered only once - when a change is required.
  49.    The user elelected options are stored in a file called "CONFIG.PC3".
  50.    An example of this file Follows:
  51.  
  52.  
  53.  
  54.    3            <------- SECURITY ALGORITHM
  55.    Y            <------- KEYS TO BE READ FROM A FILE
  56.    Y            <------- TRANSPOSITION
  57.    32           <------- LOWEST ASCII CHARACTER
  58.    125          <------- HIGHEST ASCII CHARACTER
  59.    Y            <------- ENCODED FILE HEADER
  60.    Y            <------- KEY HASK (CRC) CHECK
  61.    4            <------- FREQ/PERIOD FOR TRANSPOSITIONS
  62.    N            <------- DISPLAY ALL INPUT ON TERMINAL
  63.    Y            <------- DISPLAY ALL OUTPUT ON TERMINAL
  64.  
  65.  
  66.  
  67.           SECURITY ALGORITHM
  68.           ==================
  69.  
  70.           The user may select from up to three Psuedo Random Number
  71.           generators. A user who knows FORTRAN may also add as many
  72.           as he/she wishes - since the Source Code is provided.
  73.           As programmed the present options are 1 or 2 or 3.
  74.  
  75.  
  76.           KEYS TO BE READ FROM A FILE
  77.           ===========================
  78.  
  79.           Valid answers are "Y" for YES and "N" for NO. If the user
  80.           wishes to read this key numbers from a file enter "Y".
  81.           If "N" is specified, the user must type in these numbers.
  82.           The numbers are between 1 and 2,147,483,647. And for true
  83.           security only 6 to 8 digits numbers should be used.
  84.  
  85.           A key file is simply a series of number (4 or more)
  86.           separated by Fortran Carriage returns (and/or line feeds)
  87.           and terminated by an end of file mark (CNTL-Z).
  88.  
  89.           For example (ignoring scale):
  90.  
  91.           0        1         2    <----- File Column Position
  92.           12345678901234567890
  93.           ..........+.........
  94.           41626272
  95.           10973003
  96.           05553134
  97.           99185776
  98.           44045122
  99.           126477121
  100.           200943657
  101.           ^Z
  102.  
  103.  
  104.  
  105.  
  106.           TRANSPOSITION
  107.           =============
  108.  
  109.           Transposition is an added feature to allow Super-Encipherment.
  110.           If this option is "Y" (for YES), then the code is Scrambled
  111.           and well as encoded. This features improves security by
  112.           400 percent, but costs in execution time. Execution times
  113.           in some cases are more than doubled. If you desire is for
  114.           speed as opposed to improved security "N" is the correct
  115.           option.
  116.  
  117.  
  118.  
  119.           LOWEST ASCII CHARACTER
  120.           ======================
  121.  
  122.           Actually, this is more correctly Lowest EBCDIC character.
  123.           On the IBM PC, 32 is the Space/blank and is also the first non
  124.           special character. Characters 00 thru 31 are special
  125.           Control or Communications characters and are for the most
  126.           part "Non-printable". Refer to Appendix D (Pages D-1 thru
  127.           D-5) in the IBM BASIC Reference Manual 6361134 dated May
  128.           1984 for PC-DOS 3.0. Generally, using 32 as a default
  129.           will save later problems.
  130.  
  131.  
  132.  
  133.  
  134.           HIGHEST ASCII CHARACTER
  135.           =======================
  136.  
  137.           Actually, this is more correctly Highest EBCDIC character.
  138.           On the IBM PC, 125 is the last originary character -
  139.           excluding the non-printable graphic characters. Generally,
  140.           using a value of 125, will allow every character on any
  141.           PC keybroad.
  142.  
  143.  
  144.  
  145.           ENCODED FILE HEADER
  146.           ===================
  147.  
  148.           If this option is "Y" (for YES), than an Encoded File
  149.           will have an Header record to verify that the file
  150.           was encoded by a particular version of this program.
  151.           The program will also refuse to decode a file that
  152.           has not been encoded. This is generally a good safety
  153.           feature. A value of "N" (for NO) diables this feature.
  154.  
  155.  
  156.  
  157.           KEY HASK (CRC) CHECK
  158.           ====================
  159.  
  160.           If this Option is "Y" AND the prior option (file header)
  161.           is also "Y", then a hash total from the keys used to
  162.           encode the file is stored in the Encoded File Header
  163.           record. The Hashed number is between 000 and 996.
  164.           No security is loss by this feature of any consequences.
  165.           It protects the users from decoding a file with the wrong
  166.           keys. In rare cases, an encoded file could be destroyed
  167.           if the wrong key(s) were used (especially PC-CODE4).
  168.  
  169.  
  170.  
  171.           FREQ/PERIOD FOR TRANSPOSITIONS
  172.           ==============================
  173.  
  174.           If the user has elected to Transpose (scramble) his/her
  175.           encoded (Y) - then a new deal or permutation must be
  176.           generated for this scrambling. The highest security
  177.           means that a frequency of one (1) should be used ;
  178.           meaning a new permutation for each record. But, for
  179.           economy, it has been found that a new permuation can
  180.           be used up to 4 times - with little loss in security.
  181.           Note, also that is feature is nullified if the inputed
  182.           records are of differing lengths constantly. Each time
  183.           a record length varies from the previous length a
  184.           new deal must be generated regardless for PC-CODE3.
  185.           This restriction does not apply to PC-CODE4 where are
  186.           records are fixed at 128 characters (or 256 or 512..etc).
  187.  
  188.  
  189.  
  190.  
  191.           DISPLAY ALL INPUT ON TERMINAL
  192.           =============================
  193.  
  194.           If this option is "Y" (for YES), then all input to the
  195.           programs are listed or displayed on the Console (CRT).
  196.           This is assumed to be "CON:" on MS-DOS.
  197.  
  198.  
  199.  
  200.           DISPLAY ALL OUTPUT ON TERMINAL
  201.           ==============================
  202.  
  203.           If this option is "Y" (for YES), then all output from
  204.           the program is listed or displayed on the Console (CRT).
  205.           This is assumed to be "CON:" on MS-DOS.
  206.  
  207.  
  208.  
  209.  
  210.    * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  211.  
  212.    These programs are released in the Public Domain and only the
  213.    Commercial Rights are Reserved.   By Richard Nolen COLVARD.
  214.  
  215.    * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  216.  
  217.