home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / compress / epu10.lha / epu.doc < prev    next >
Text File  |  1989-10-17  |  10KB  |  260 lines
  1.  
  2.                            ==================
  3.                            |    EPU  v1.0.  |
  4.                            ==================
  5.  
  6.               Stacker or XPK like(but different) system for Amiga.
  7.  
  8.                     Using lh.library is possible.
  9.  
  10. EPU is a packing system  which allows user and the applications to access
  11. compressed data from amiga dos devices without knowing that they are 
  12. compressed and of course if a new data are created (save)
  13. they are automaticaly compressed.
  14.  
  15.   
  16.   EPU consists of this files:
  17.  
  18.      EPU1.handler \  
  19.      EPU2.handler  >  put them into your l: directory
  20.      EPU3.handler /
  21.     
  22.      EPU0.library \   
  23.      EPU1.library  >  put them into your libs: directory
  24.        lh.library /
  25.  
  26.      EPU              its a CLI command,so you can put it in c: directory
  27.  
  28.  
  29.   First thing,you have to do is assign EPU system to device you want to
  30.   work to. Let's say you want to work with your rad: disk.
  31.   You will simply type in cli:
  32.                    EPU device rad       (do not type ':' after device name)
  33.   Now when some task will write to rad: the file will be compressed,
  34.   when another task will read this file then will receive the file decompressed.
  35.  
  36.   Now you can do any I/O operation with files in rad: (read/write/seek/close/
  37.   open/examine even  an unlimitet number of task can read/write into one
  38.   file(in epu compress format) in the same time!!! ) and after decompressing
  39.   it the file will be the same like you have never been using EPU,but you
  40.   saved a lot of disk space.
  41.   It also mean that you can simply join file to compressed file by >> shell
  42.   redirection.
  43.  
  44.   The file size is not limited by memory because only a small part of file
  45.   is in memory when working with it( The theoretic maximum size is 1.2GB). 
  46.                          
  47.  The EPU command syntax:
  48.  
  49. EPU DEVICE name [SAVE/NOSAVE] [LOAD/NOLOAD] [EXAMINE/NOEXAMINE] 
  50.  [NoExNext/ExNext] [LMODE/HMODE] [BLOCK number] [TABLE Number] [LIBRARY name]
  51.  [INFO/CHNG/KILL]
  52.  
  53.  DEV is the synonym of DEVICE
  54.  LIB is the synonym of LIBRARY
  55.  
  56.   options:
  57.      NoSave - when  creating new file under epu, it will not be
  58.               compresed (simply packet ACTION_FINDOUTPUT is ignored);
  59.               [file will not be compressed,when saving]
  60.      Save - default option : file will be compresed every time.
  61.  
  62.      NoLoad - when accessing file compressed by EPU system, it will not be
  63.               decompressed(simply packet ACTION_FINDINPUT is ignored);
  64.               Usefull when EPU is still instaled and you want to copy some
  65.               EPU file( epu file is file which is in epu compress format)
  66.               to another place without decompressing.
  67.      Load -  default option : Epu file will be decompressed every time.
  68.  
  69.      Examine - Default option : when  examining EPU file(for example 
  70.               list c:dir) you will get its virtual file size( that mean the
  71.               size what you get after decompressing). 
  72.      NoExamine -  when  examining EPU file  you will get its real size on
  73.               the disk( simply packet ACTION_EXAMINE is ignored);
  74.  
  75.      ExNext - Default option : when examining directory contents ( f.e. list c:)
  76.            you will get virtual file sizes of files in this directory.
  77.      NoExNext - when examining directory contents 
  78.            you will get real file sizes of files in this directory
  79.            (simply packet ACTION_EXNEXT is ignored);
  80.      
  81.      Hmode - Default option: when file is saved (opened by opt MODE_NEWFILE) EPU
  82.            system will look whether the first compressed part is bigger than
  83.            before compressing and if so EPU will not create standart EPU
  84.            file but will save it as normal file.
  85.            That mean  when saving once compressed file it will not be compressed
  86.            again.
  87.      Lmode- when saving file, it will allways be created in standart EPU format.
  88.   
  89.   parameters:  
  90.      BLOCK  - sets block size for file which can be between 2 - 60 Kb.
  91.               Default size is 10.
  92.               When a small size is choosen you will need less memory,but 
  93.               speed and compression ratio can be worse.
  94.               When you set BLOCK 20 you will need 2*20Kb for opened file.
  95.  
  96.      TABLE - sets maximum of blocks for one opened file.
  97.              Default size is 1000 (can be betwee 500 - 20000 ).
  98.              So when block size is 20 and table is 1000 the file size
  99.              can be maximal 20 MB large ( 20*1000*1000 Bytes)
  100.  
  101.      LIBRARY - default epu0: Here can be specified which compression/decompression
  102.             library will be used to pack the file. (the name of library
  103.             must be without the .library extension.) Now are available
  104.             two libs: epu0.library and epu1.library. 
  105.  
  106.        The values of TABLE,LIBRARY and BLOCK are only used when creating new
  107.        EPU file, when opening old epu file, the values in its header are used. 
  108.  
  109.   comms:
  110.      Info - gives current epu setings for given device(if assigned by EPU)
  111.             when for example will be typed:     EPU device rad info 
  112.             it will print  something like this:
  113.  
  114.                      STATUS:
  115.                        LOAD / SAVE / EXAM / EXNEXT / HMODE
  116.                        BLOCK:    10
  117.                        TABLE:    1000
  118.                        LIBRARY:  epu0
  119.  
  120.      Chng - current setings of epu can be changed.
  121.             for ex. EPU dev rad NoSave Load Block 20 chng
  122.             will change block size to 20 and sets options to NoSave,Load;
  123.             the other setings will be unchanged.
  124.  
  125.      Kill - Removes EPU from device.
  126.             for ex. EPU dev rad kill 
  127.             will remove EPU system from rad device.
  128.             When some files are opened under EPU when killing it,
  129.             the epu will wait till all this files will be closed and then
  130.             will kill itself(in this waiting time can't be epu installed 
  131.             again).
  132.  
  133.      When no command is given epu will try to install to given device.
  134. ---------------------------
  135.  
  136. There can appear 2 new I/O error messages when working under epu:
  137. 1) ERROR_BAD_FILE - its number is 3020 . 
  138.    This error mean that the epu file is not valid(damaged etc.).
  139. 2) ERROR_OPEN_UNPOSSIBLE -its number is 3021 .
  140.    This error mean that file can't be opened because of there is no mem
  141.    to allocate buffers or epu can't open compress library  which the file 
  142.    requires.
  143.  
  144. Notices:
  145.  
  146.  EPU cli command can be loaded resident.
  147.  The EPU handlers are loaded resident to memory after first using of EPU command.
  148.  
  149.  Instead of the name of device you can type name of volume, then the epu
  150.  will be installed to the device in which  the volume is inserted.
  151.  It's usefull when epu command is used in startup sequence and
  152.  we do not know which drive will be used to boot.
  153.  
  154.  Epu do not change any library vector(so others programs which access
  155.  device directly ,without using dos.library, are also handled)
  156.  
  157.  When the file is compressed(decompressed) the device is not blocked
  158.  and can be used by anothers programs.
  159.  
  160.  Example how compress your Workbench disk to save about 300Kb space(size of
  161.  saved space depends on library you have used to compress files).
  162.  You must first compress all files(Icons/libraries/progs. etc.) to blank
  163.  disk. You can't only compress files that are used before executing startup
  164.  sequence(that is system-configuration and startup-sequence) they must be
  165.  uncompressed. The last step is to change the startup-sequence.
  166.  At the first line you must write: EPU dev volume-name 
  167.  And now you can boot from this disk.
  168.  Of course you can compress any others disks or hard disk by this way.
  169.  I used this method to compress Workbench 1.3.(epu1.library used).
  170.  After compressing all files and installing epu about 300KB remained
  171.  free on the disk.That mean I was able to store about 400 KB large files
  172.  from Extras disk on Workbench disk !!!!!!!!
  173.  
  174.  epu0.library - this library is based on LZSS algor.. That mean the 
  175.   compression is slow,but decompression is fast enought.The compression
  176.   ratio is also nothing special. 
  177.  epu1.library - it is the interface between epu and lh.library.
  178.   the compression ratio is very good(better than PowerPacker) ,the speed too.
  179.   [lh.library is the product of O. Barthel & P. Krekel , you can find it on
  180.    Fish disk with documentation]
  181. Testing:
  182.   EPU works with 1.3 and 2.0. filesystem,fastfilesystem,rad and other standart
  183.   devices.
  184.   EPU does not currently work with 2.0. ram: device.
  185.   Do not also install epu to devices which do not support Seek and Lock
  186.   packets(PIPE,NULL).
  187.  
  188. WARNING:
  189.   You are using this program on your own risk.
  190.  
  191. POSTING:
  192.    
  193.   You can send bugs,new ideas,opinions to this internet e-mail address
  194.  
  195.     jara@adelard.dcs.muni.cs  
  196.     jara@lion.ics.muni.cs
  197.   
  198.   or you can write to:
  199.  
  200.      J. Mechacek
  201.     Mutenicka 7
  202.     628 00 Brno
  203.     Czech Republic
  204.         Europe
  205.     
  206.  
  207. What the 2.0. version will include:
  208.   
  209.    Intuition Interface(instead of EPU cli command) to allow fast handling with 
  210.     epu tasks.
  211.    New libs.
  212.    The possibility to have the different options(SAVE,NOSAVE ...) for
  213.    each directory or volume.
  214.  
  215. I apologize for grammar mistakes that may be in this text,because
  216. I don't speak English very much and this text was writen in very short time.
  217.  
  218.  
  219.  
  220.                      EPU 1.0.  distribution
  221.                      ======================
  222.  
  223. EPU is SHAREWARE program and can be distributed only for non-commercial use
  224. and the epu.doc must be included:
  225.   
  226. No file is allowed to be changed.
  227.  
  228. How to register:
  229.  
  230.   Send US $15 when you are using EPU .
  231.  
  232.  You will receive free EPU 2.0.
  233.  
  234. Where to send the money:
  235.  
  236.   1)
  237. Account Name: Jaroslav Mechacek,Mutenicka 7
  238. Account Number: 34278-314558-621
  239. Bank address:      
  240.      Commercial Bank
  241.     Brno-mesto
  242.     nam. Svobody 21
  243.     631 31 Brno
  244.     Czech Republic
  245.     Europe
  246.        
  247. If you have e-mail address don't forget to mail me it.  
  248.  
  249.   2) Send the money in insured registered letter to this address:
  250.        
  251.     J. Mechacek
  252.     Mutenicka 7
  253.     628 00 Brno
  254.     Czech Republic
  255.         Europe
  256.  
  257.  DO NOT USE ANY OTHER WAY 
  258.  
  259.  
  260.