home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / map3.dms / map3.adf / EPU / Doc / EPU.doc < prev    next >
Text File  |  1993-06-13  |  12KB  |  305 lines
  1.  
  2.                            ==================
  3.                            |    EPU  1.4    |
  4.                            ==================
  5.  
  6.      Stacker like program  - CAN DOUBLE YOUR (HARD)DISKS CAPACITY
  7.  
  8.  
  9. DESCRIPTION:
  10.  
  11.   After installing EPU to any Device(HardDisk,Floppy,Rad etc) every
  12.   file which will be written to the device will be compressed and when
  13.   any compressed file is read by any application it will be autmaticaly
  14.   decompresed. 
  15.  
  16.   EPU is very easy to install or remove, its size is very small,
  17.   can work with many compress libraries like lh.library or xpk(NUKE,...).  
  18.  
  19.   The file sizes are not limited by memory,
  20.   (maximal file size is about 1GB).
  21.  
  22.   There are no differences or limitations when you are working with installed 
  23.   epu or without it(of course it can be slower if the CPU is slow.)
  24.  
  25. NEW FEATURES:
  26.  
  27.  1. This version runs on ALL machines and with ALL OS 
  28.     (The previous 1.0 version didn't work on A3000/A4000)-KS1.2 was not tested.
  29.  2. Now EPU can work with xpk sublibraries like NUKE etc.
  30.  
  31.  
  32.   EPU consists of this files:
  33.  
  34.      EPU1.handler \  
  35.      EPU2.handler  >  put them into your l: directory
  36.      EPU3.handler /
  37.     
  38.      EPU0.library \   
  39.      EPU1.library  >  put them into your libs: directory
  40.        lh.library /
  41.  
  42.      EPU              its a CLI command,so you can put it in c: directory
  43.  
  44.  
  45.   First thing,you have to do is assign EPU system to device you want to
  46.   work to. Let's say you want to work with your rad: disk.
  47.   You will simply type in cli:
  48.                    EPU device rad       (do not type ':' after device name)
  49.   Now when some task will write to rad: the file will be compressed,
  50.   when another task will read this file then will receive the file decompressed.
  51.  
  52.   Now you can do any I/O operation with files in rad: (read/write/seek/close/
  53.   open/examine even  an unlimitet number of task can read/write into one
  54.   file(in epu compress format) in the same time!!! ) and after decompressing
  55.   it the file will be the same like you have never been using EPU,but you
  56.   saved a lot of disk space.
  57.   It also mean that you can simply join file to compressed file by >> shell
  58.   redirection.
  59.  
  60.   The file size is not limited by memory because only a small part of file
  61.   is in memory when working with it( The theoretic maximum size is 1.2GB). 
  62.                          
  63.  The EPU command syntax:
  64.  
  65. EPU DEVICE name [SAVE/NOSAVE] [LOAD/NOLOAD] [EXAMINE/NOEXAMINE] 
  66.  [NoExNext/ExNext] [LMODE/HMODE] [BLOCK number] [TABLE Number] [LIBRARY name]
  67.  [INFO/CHNG/KILL]
  68.  
  69.  DEV is the synonym of DEVICE
  70.  LIB is the synonym of LIBRARY
  71.  
  72.   options:
  73.      NoSave - when  creating new file under epu, it will not be
  74.               compresed (simply packet ACTION_FINDOUTPUT is ignored);
  75.               [file will not be compressed,when saving]
  76.      Save - default option : file will be compresed every time.
  77.  
  78.      NoLoad - when accessing file compressed by EPU system, it will not be
  79.               decompressed(simply packet ACTION_FINDINPUT is ignored);
  80.               Usefull when EPU is still instaled and you want to copy some
  81.               EPU file( epu file is file which is in epu compress format)
  82.               to another place without decompressing.
  83.      Load -  default option : Epu file will be decompressed every time.
  84.  
  85.      Examine - Default option : when  examining EPU file(for example 
  86.               list c:dir) you will get its virtual file size( that mean the
  87.               size what you get after decompressing). 
  88.      NoExamine -  when  examining EPU file  you will get its real size on
  89.               the disk( simply packet ACTION_EXAMINE is ignored);
  90.  
  91.      ExNext - Default option : when examining directory contents ( f.e. list c:)
  92.            you will get virtual file sizes of files in this directory.
  93.      NoExNext - when examining directory contents 
  94.            you will get real file sizes of files in this directory
  95.            (simply packet ACTION_EXNEXT is ignored);
  96.      
  97.      Hmode - Default option: when file is saved (opened by opt MODE_NEWFILE) EPU
  98.            system will look whether the first compressed part is bigger than
  99.            before compressing and if so EPU will not create standart EPU
  100.            file but will save it as normal file.
  101.            That mean  when saving once compressed file it will not be compressed
  102.            again.
  103.      Lmode- when saving file, it will allways be created in standart EPU format.
  104.   
  105.   parameters:  
  106.      BLOCK  - sets block size for file which can be between 2 - 60 Kb.
  107.               Default size is 10.
  108.               When a small size is choosen you will need less memory,but 
  109.               speed and compression ratio can be worse.
  110.               When you set BLOCK 20 you will need 2*20Kb for opened file.
  111.  
  112.      TABLE - sets maximum of blocks for one opened file.
  113.              Default size is 1000 (can be betwee 500 - 20000 ).
  114.              So when block size is 20 and table is 1000 the file size
  115.              can be maximal 20 MB large ( 20*1000*1000 Bytes)
  116.  
  117.      LIBRARY - default epu0: Here can be specified which compression/decompression
  118.             library will be used to pack the file. 
  119.             There are only two libs in the package(epu0 and epu1).
  120.             example:  lib epu0    or   lib epu1
  121.             BUT do not forget that epu can now work with all XPK
  122.             packer libs like NUKE(the best library)  HUFF SHRI  and so on.
  123.             example: lib NUKE    or    lib SHRI         .......
  124.             This libs are not included but you can obtain them from XPK
  125.             package(amiga.physik.unizh.ch or Fish disk no. 754 etc.).
  126.             Epu does not support libs which require password.
  127.  
  128.  
  129.        The values of TABLE,LIBRARY and BLOCK are only used when creating new
  130.        EPU file, when opening old epu file, the values in its header are used. 
  131.  
  132.   comms:
  133.      Info - gives current epu setings for given device(if assigned by EPU)
  134.             when for example will be typed:     EPU device rad info 
  135.             it will print  something like this:
  136.  
  137.                      STATUS:
  138.                        LOAD / SAVE / EXAM / EXNEXT / HMODE
  139.                        BLOCK:    10
  140.                        TABLE:    1000
  141.                        LIBRARY:  epu0
  142.  
  143.      Chng - current setings of epu can be changed.
  144.             for ex. EPU dev rad NoSave Load Block 20 chng
  145.             will change block size to 20 and sets options to NoSave,Load;
  146.             the other setings will be unchanged.
  147.  
  148.      Kill - Removes EPU from device.
  149.             for ex. EPU dev rad kill 
  150.             will remove EPU system from rad device.
  151.             When some files are opened under EPU when killing it,
  152.             the epu will wait till all this files will be closed and then
  153.             will kill itself(in this waiting time can't be epu installed 
  154.             again).
  155.  
  156.      When no command is given epu will try to install to given device.
  157. ---------------------------
  158.  
  159. There can appear 2 new I/O error messages when working under epu:
  160. 1) ERROR_BAD_FILE - its number is 3020 . 
  161.    This error means that the epu file is not valid(damaged etc.).
  162. 2) ERROR_OPEN_UNPOSSIBLE -its number is 3021 .
  163.    This error means that the file can't be opened because of there is no mem
  164.    to allocate buffers or epu can't open compress library  which the file 
  165.    requires.
  166.  
  167. ---------------------------------------------------------------------
  168.   Recomp
  169.  
  170.  In the util directory you can find program Recomp. It can help you
  171.  to compress the files on your (Hard)disk or recompress them by another
  172.  library.It's simple but can be usefull. Read the Recomp.doc .
  173.  
  174. ----------------------------------------------------------------------
  175. Notices:
  176.  
  177.  EPU cli command can be loaded resident.
  178.  The EPU handlers are loaded resident to memory after first using of EPU command.
  179.  
  180.  Instead of the name of device you can type name of volume, then the epu
  181.  will be installed to the device in which  the volume is inserted.
  182.  It's usefull when epu command is used in startup sequence and
  183.  we do not know which drive will be used to boot.
  184.  
  185.  Epu do not change any library vector(so others programs which access
  186.  device directly ,without using dos.library, are also handled)
  187.  
  188.  When the file is compressed(decompressed) the device is not blocked
  189.  and can be used by anothers programs.
  190.  
  191.  Example how compress your Workbench disk to save about 300Kb space(size of
  192.  saved space depends on library you have used to compress files).
  193.  You must first compress all files(Icons/libraries/progs. etc.) to blank
  194.  disk. You can't only compress files that are used before executing startup
  195.  sequence(that is system-configuration and startup-sequence) they must be
  196.  uncompressed. The last step is to change the startup-sequence.
  197.  At the first line you must write: EPU dev volume-name 
  198.  And now you can boot from this disk.
  199.  Of course you can compress any others disks or hard disk by this way.
  200.  I used this method to compress Workbench 1.3.(epu1.library used).
  201.  After compressing all files and installing epu about 300KB remained
  202.  free on the disk.That mean I was able to store about 400 KB large files
  203.  from Extras disk on Workbench disk !!!!!!!!
  204.  
  205.  epu0.library - this library is based on LZSS algor.. That mean the 
  206.   compression is slow,but decompression is fast enought.The compression
  207.   ratio is also nothing special. 
  208.  epu1.library - it is the interface between epu and lh.library.
  209.   the compression ratio is very good(better than PowerPacker) ,the speed too.
  210.   [lh.library is the product of O. Barthel & P. Krekel , you can find it on
  211.    Fish disk with documentation]
  212.  
  213.  I SUGGEST TO USE THE NUKE LIBRARY - IT'S THE BEST
  214.  
  215. Testing:
  216.   EPU works with 1.3 and 2.0 3.0 filesystem,fastfilesystem,rad and other standart
  217.   devices.
  218.   EPU does not currently work with 2.0. ram: device.
  219.   Do not also install epu to devices which do not support Seek and Lock
  220.   packets(PIPE,NULL).
  221.  
  222. WARNING:
  223.   You are using this program on your own risk.
  224.  
  225.    
  226. You can send bugs,new ideas,opinions to this internet e-mail address
  227.  
  228.     jara@adelard.dcs.muni.cs  
  229.     jara@lion.ics.muni.cs
  230.   
  231.   or you can write to:
  232.  
  233.      J. Mechacek
  234.     Mutenicka 7
  235.     628 00 Brno
  236.     Czech Republic
  237.         Europe
  238.     
  239.  
  240.  
  241.  
  242. DISTRIBUTABILITY:
  243.  
  244.   Can be distributed as shareware - all unchanged files must be included.
  245.   The original EPU14.lha file can be posted by e-mail or uploaded
  246.   without any permission.
  247.  
  248.  
  249.                      How to register
  250.                      ===============
  251.  
  252.  
  253.  
  254. Epu 1.4 is SHAREWARE , so if you use it you should send US $20
  255.                                                         ------
  256. There is also an special offer how to get the Epu2.0 which will not be
  257. Shareware:                                                 -----------
  258.  
  259.   - if you pay $20 to 30 October 1993 you will receive Epu2.0 free.
  260.     ( I prefer to send it by e-mail so don't forget to write it )
  261.                          
  262.   - if you pay $20 to 30 June 1993 you will receive all Epu versions
  263.     which will be released - but you must have an e-mail address :
  264.     the Epu2.0 you will receive on the disk if you do not have e-mail
  265.     address but the next versions will be only e-mailed. 
  266.  
  267. Fill and send(e-mail) me this registration form:
  268.  
  269. -------------------------------------------------
  270. Name:
  271. Address:
  272. e-mail:
  273. Date when you sent the registration fee:
  274.  
  275. (Hardware):
  276. (Notices):
  277. -------------------------------------------------
  278.  
  279. Where to send the fee:
  280.  
  281.   1)
  282. Account Name: Jaroslav Mechacek,Mutenicka 7
  283. Account Number: 34278-314558-621
  284. Bank address:      
  285.      Commercial Bank
  286.     Brno-mesto
  287.     nam. Svobody 21
  288.     631 31 Brno
  289.     Czech Republic
  290.     Europe
  291.        
  292.  
  293.   2) Send the fee in insured registered letter to this address:
  294.        
  295.     J. Mechacek
  296.     Mutenicka 7
  297.     628 00 Brno
  298.     Czech Republic
  299.         Europe
  300.  
  301.  DO NOT USE ANY OTHER WAY 
  302.  
  303.  
  304.  
  305.