home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / util / arc / lino / doc / lino.doc < prev    next >
Encoding:
Text File  |  1995-04-13  |  5.6 KB  |  159 lines

  1.  
  2.  ****  LINO - lino.doc    ****
  3.  
  4.  
  5.  
  6.  The XPK standard (see references at the end of this file)
  7.  is an interfacing standard between applications and packer libraries.
  8.  Some important applications for data compression are:
  9.  Data Archiving, Backup-Utilities, Harddisk compression, Terminal programs.
  10.  
  11.  Your file, that should be compressed, will be splittet into a number of
  12.  chunks, which will be compressed from your packer. Your application will
  13.  reserve two memory buffers, one for (uncompressed) input data, one for
  14.  (compressed) output data.
  15.  With the following formula, you can calculate memory usage.
  16.    +  memory usage of your application
  17.    +  2 * chunksize
  18.       (it's a little bit more to prevent a buffer overflow, if file is
  19.        already packed)
  20.    +  length of packer library (a few kb in most cases)
  21.    +  memory usage of packer library
  22.       (depends on selected mode - see info about your packer)
  23.  
  24.  Lino doesn't need xpkmaster.library, so it has its own file format
  25.  (see 'lino.c'), but it recognizes also the file formats used by
  26.  XPK/XFH, EPU and Disk Expander.
  27.  
  28.  XLIN is an extended version of LINO. The only difference is, that XLIN has
  29.  implemented the four compression libraries LIN1, LIN2, LIN3 and LIN4.
  30.  
  31.  
  32.  Parameters
  33.  (You get a list of parameters with Usg. LINO/XLIN without parameters or
  34.   with '?' as parameter.)
  35.  
  36.  <file> Name of the file, that should be compressed (path should be
  37.     included).
  38.  
  39.   -w    Destination path/file, can be another device, of course.
  40.     If source and destination is identical, lino will create a temporary
  41.     file. So, if you have a crash during compressing/expanding, you are
  42.     able to restore the original file.
  43.  
  44.   -s    Suffix, will be added to the filename of the compressed file
  45.     and removed, if you select expanding.
  46.  
  47.   -m    Packing method. Short (4 letter) name of a packer. You may add the
  48.     mode to the method (f.e.: ZENO.100).
  49.  
  50.   -e    Efficiency/Mode, '0' means the worst compression ratio, but in most
  51.     cases the compression will be fastest and the memory use is minimal.
  52.     If you don't select a mode, you accept the default mode of the
  53.     packer. See info about your packer (-i).
  54.  
  55.   -c    Chunksize. A size smaller than 20 (Kb) will reduce compression ratio.
  56.     A size higher than 60 maybe won't produce a ratio, that is
  57.     significant higher, and needs much memory. But it differs from packer
  58.     to packer. You should consider, that expanding will use the same
  59.     chunksize as compressing.
  60.     The default size is 32. If your input is '-1', lino will get the
  61.     default size from your packer. See info about your packer (-i).
  62.  
  63.   -p    Password, is any kind of text. It's evident, that you also need this
  64.     password to expand your file!
  65.  
  66.   -z    Minimal size of file, means that smaller files will not compressed.
  67.     There are two reasons, why you should not reduce the default size
  68.     of 250: At first, most of the compression algorithms need a minimum
  69.     of bytes to work, at second, compressed files get a file header of
  70.     48 bytes.
  71.  
  72.   -y    Taskpriority. You can accelerate compressing/expanding, if you don't
  73.     have running other programs. If you are compressing in the
  74.     background, you should select a value less than 0. A range from -50
  75.     to +50 is allowed, default is -5.
  76.  
  77.   -l    Errorlevel. An error with higher value will cause a break.
  78.     If you pack a directory or device, you can take a higher
  79.     value (range: -42 to +5, default: -17). See errorcodes in
  80.     'src/lino.c'.
  81.  
  82.   -b    Overflow buffer. It could be safer to select 3 (largest) or 4 instead
  83.     of default: 5.
  84.  
  85.  
  86.   -u    Expansion. Lino will always try to compress except you select '-u'.
  87.  
  88.   -h    Hidden password entry. You will not see your entered password on the
  89.     screen, but maybe your con-handler will show your entry, if you hit
  90.     'arrow up' key. Close your entry with key 'Return'.
  91.  
  92.   -x    Executable files only. Will be recognized at the first longword.
  93.  
  94.   -d    Data files only.
  95.  
  96.   -n    No output anywhere.
  97.  
  98.   -o    Output will directed to printer.
  99.  
  100.   -a    All subdirectories are included. (Lino will create destination
  101.     directories).
  102.  
  103.   -k    Compression/Expansion speed is shown in kilobytes per second instead
  104.     of bytes per second.
  105.  
  106.   -i    Information about a packer. Use "-i -m PACK" as arguments.
  107.  
  108.   -t    Time will be outputted, if you compress a whole directory or device.
  109.     I used this to compare compression/expansion speed.
  110.  
  111.   -f    If you use an encrypting library instead of a compressing library,
  112.     it is possible, that destination/encrypted file is larger, than
  113.     original file.
  114.  
  115.  
  116.      Pattern matching: You can use the usual wild cards, also '*' instead
  117.      of '#?', and '!' to negate the pattern.
  118.  
  119.      Abort program: You can abort lino between compressing/expanding
  120.      two files with key 'SHFT' and left mouse button.
  121.  
  122.  
  123.      Here are some examples:
  124.  
  125.      lino text -s .xp -m ZENO -c 60 -e 100
  126.  
  127.      will compress the file 'text', with the xpkZENO.library, a chunksize
  128.      of 60, mode 100, add a suffix '.xp' to the name of the compressed
  129.      file and save this file (text.xp) in the same directory.
  130.  
  131.      lino df0:back/!f#? -u -w dh0:tools/
  132.  
  133.      copy and expand all files whose filenames don't begin with a 'f'
  134.      of the directory 'df0:back' into directory 'dh0:tools'
  135.      (don't forget this: '/').
  136.  
  137.      lino -m lin1.50 -p Sirius picture1
  138.  
  139.      will compress the file 'picture1' with the lib 'lin1' and mode 50.
  140.      For expanding you will need the password 'Sirius'.
  141.  
  142.  
  143.  
  144.  
  145.  ______________________________________________________
  146.  Programs, Applications, Authors/Copyrights, References
  147.  
  148.  XPK:  Urban Dominik Mueller a.o. (Fish 754)
  149.  NUKE: Urban Dominik Mueller
  150.  BLZW: Bryan Ford
  151.  FAST: Christian von Roques
  152.  
  153.  XFH:  Kristian Nielsen
  154.  EPU:  Jaroslav Mechacek (V1.4: Fish 858)
  155.  Disk Expander: Stefan Ossowski (is the professional successor of EPU)
  156.  ABackup (Fish 838)
  157.  
  158.  
  159.