home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / files / a / amffcoder / !Help next >
Encoding:
Text File  |  1992-10-11  |  6.3 KB  |  145 lines
  1. AMFFileCoder  1.10 (11-Oct-92)
  2. ==============================
  3. File Encryption
  4. ===============
  5. AMFFileCoder is a small module that,when loaded and activated,will
  6. automatically encode all files that are saved of a given filetype,and
  7. automatically decode these files when they are reloaded.It saves the time
  8. of manually encrypting a file,using a program such as AMFCoder (which,
  9. incidentally,allows a far greater range of encryption options than
  10. AMFFileCoder,operating on all filetypes,but manually),by automatically
  11. encoding and decoding all files of a particular filetype.
  12.  
  13. Operation
  14. =========
  15. AMFFileCoder operates in the following way.Once loaded,the command
  16. AMFFileCoderOn is entered from the oscli (*) prompt,together with a password
  17. that was given when AMFFileCoder was created.Whenever a file is either
  18. completely loaded,or completely saved,it's filetype is checked,and should
  19. this be the filetype that AMFFileCoder is looking out for,it will either
  20. encrypt or decrypt that file,so that the copy of the file on disc is
  21. encrypted,but the copy of the file in memory is decrypted.Thus,when you
  22. switch off your computer,and leave your vital information (should you have
  23. any) lying around,it will automatically have been encrypted without you
  24. having to worry about it,and cannot be decrypted unless the correct version
  25. of AMFFileCoder is loaded,and the correct password given.AMFFileCoder can
  26. also be switched off,using the AMFFileCoderOff command,which,once again,
  27. requires a password.
  28.  
  29. Setting Up
  30. ==========
  31. Within this directory,a BASIC program named CrFileCode is included to create
  32. a version of the AMFFileCoder module.When run,a password is asked for.This
  33. password is used both to activate and deactivate AMFFileCoder.It is
  34. important that it is remembered.You will then be asked for two EOR codes,one
  35. being an Initial EOR code,and one being an Extended EOR code.These are used
  36. to create an encryption table that is used to code and decode the selected
  37. files.Finally,you will be asked for the filetype of the files that you wish
  38. to encrypt/decrypted.It is recommended that this should be one of the user
  39. filetypes (000-800),or the text filetype (FFF),although this can cause
  40. problems with normal text files.
  41.  
  42. The encryption table will be created,and checked to see whether it is a
  43. valid encryption table.If not,the error Encryption table faulty will be
  44. generated,and you will have to start again,changing the EOR codes entered.If
  45. the table is sound,a unique encryption code will be generated,allowing you
  46. to check different versions of AMFFileCoder,without giving away the actual
  47. encryption table.Finally,a file name to save the module as will be requested,
  48. and the module will be saved.
  49.  
  50. * Commands
  51. ==========
  52. The AMFFileCoder module contains three * commands that are used in the
  53. encryption process.These may be entered either by pressing f12 from the
  54. desktop,using the desktop New Task option from the Task Manager icon menu,
  55. or from any CLI shell,as with normal * commands.These commands are as
  56. follows:
  57.  
  58. *AMFFileCoderOn <password>
  59. *AMFFileCoderOn will switch on the AMFFileCoder module if it has previously
  60. been switched off,or if it has only just be loaded,and is thus inactive.It
  61. requires the password that was given when AMFFileCoder was created (above).
  62.  
  63. *AMFFileCoderOff <password>
  64. *AMFFileCoderOff will switch off the AMFFileCoder module,so long as the
  65. correct password is given.This is to allow alterations to be made to
  66. previously unreadable files,and to allow the transfer of normal files to
  67. encoded files.
  68.  
  69. *AMFFileCoderCreate <filename>
  70. *AMFFileCoderCreate will create a blank file that will automatically be
  71. encrypted/decrypted should more information be added to it using a text
  72. editor that preserves filetypes,for example Edit.
  73.  
  74. Protection
  75. ==========
  76. AMFFileCoder will encrypt/decrypt the following file operations:
  77.  
  78. OS_File 0 and 10 (save)
  79. OS_File 12,14,16 and 255 (load)
  80.  
  81. These include the two file operations that Edit uses to save and load
  82. complete files,so it allows AMFFileCoder to automatically encode all files
  83. saved or loaded by Edit using the correct filetype.
  84.  
  85. This is achieved by means of a vector claim to the appropriate vectors that
  86. is reinitialised after a reset.This means,simply,that AMFFileCoder will
  87. still work after a machine has been reset,although not after a complete shut
  88. down,for nothing can survive that!
  89.  
  90. Conversion
  91. ==========
  92. Converting unencrypted files to encrypted files is slightly difficult.
  93. Firstly,make sure AMFFileCoder is off,and load an normal version of Edit.
  94. Then,load as many files as you wish to encode,switch AMFFileCoder off,load
  95. the files into Edit,switch AMFFileCoder on,and save the files into the
  96. required position.Similarly,to convert encrypted files to unencrypted files,
  97. load Edit,switch AMFFileCoder on,load the files,switch AMFFileCoder off,and
  98. save the files again.
  99.  
  100. To speed this rather slow process up,set the following function key
  101. definitions:
  102.  
  103. *Key 1 AMFFileCoderOn <password>|M
  104. *Key 2 AMFFileCoderOff <password>|M
  105.  
  106. where password is replaced with your correct password.Now press f12,then
  107. either f1 or f2 to switch on/off AMFFileCoder
  108.  
  109. Known Problems
  110. ==============
  111. Due to the nature of AMFFileCoder,it cannot encode files that are saved
  112. using the OS_BGet,OS_BPut or OS_BGBP routines,or decode encrypted files
  113. that are loaded using these routines.This means that certain parts of the
  114. operating system that use these routines will not appreciate encoded files,
  115. notably *Dump,*Type,etc.To be ensured of decryption/encryption,use the
  116. appropriate part of OS_File (either 0 or 10 for saving, and 12,14,16 or 255
  117. for loading).
  118.  
  119. AMFFileCoder is designed to work with most simple text editors, for example
  120. Edit and StrongEd2,and has been tested rigourously on these programs.However
  121. the author of this software cannot accept any liability for any loss or
  122. damage arising from the use or misuse of AMFFileCoder.If in doubt,check
  123. first.
  124.  
  125. Versions
  126. ========
  127. 1.00 Original version.
  128.  
  129. 1.10 OS_File 10,12,14 and 16 now supported. This allows alternative text
  130.      editors, for example, the excellent StrongEd2, to be used, as well as
  131.      Edit.
  132.  
  133. Addresses
  134. =========
  135. Should you wish to contact the author of this software,make any constructive
  136. comments or suggestions,report any errors or bugs,or make any donations (all
  137. cheques being made payable to A.M.Flintham),write to the address beneath:
  138.  
  139. AMF the Doomwatcher,
  140.   The Monastery of Doomwatcher Monks,
  141.     50 Burlington Way,
  142.       Mickleover,
  143.         Derby.
  144.           DE3 5BD
  145.