home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / mdc1_17.lha / MDC / MDC680X0.Doc < prev   
Encoding:
Text File  |  1995-02-15  |  17.3 KB  |  414 lines
  1. ---------------------------------------------------------------------------
  2.  
  3.   Marcs Disk Cruncher 68000 V1.17 And
  4.   Marcs Disk Cruncher 68020 V1.17 User Documentation
  5.  
  6.   Copyright © 1995 By Marko Pozarnik
  7.  
  8. ---------------------------------------------------------------------------
  9.   Preface
  10. ---------------------------------------------------------------------------
  11.  
  12.   Please  NOTE  this  documentation  is  a kind of preview for the porgram.
  13. Some  options  described below aren't supported yet.  I put this program on
  14. AmiNet to see your reactions. My E-Mail adress is bellow.
  15.  
  16.   This  unregistered  version of the program and files in this distribution
  17. are freely distributable, but are also copyright © By Marko Pozarnik.  They
  18. may  be freely distributed as long as no more than a nominal fee is charged
  19. to cover time and copying costs.
  20.   Commercial usage is permitted with this sentence.
  21.   Everything  in  this  distribution  must  be  kept  together, in original
  22. unmodified form.
  23.   The above is generally known as shareware.
  24.  
  25. ---------------------------------------------------------------------------
  26.  
  27.   The version of the program in this distribution is not registered!
  28.  
  29. ---------------------------------------------------------------------------
  30.  
  31.   Please contact me if you have any comments or suggestions:
  32.  
  33.   E-Mail: marko.pozarnik@uni-mb.si
  34.  
  35.   Mail: Marko Pozarnik
  36.         Prusnikova 4
  37.         62000 Maribor
  38.         Slovenia
  39.  
  40.   Phone: +368 (0) 62 38 303 (From 10 PM to 2 AM MET)
  41.  
  42.   IRC: SSMP
  43.  
  44. ---------------------------------------------------------------------------
  45.  
  46.   I think KS 2.0 and later required. It doesn't work on KS 1.3.
  47.  
  48. ---------------------------------------------------------------------------
  49.  
  50.   I  would  like to thank ZPiff for his help in using Xpk libraries.  I had
  51. some  problems  and couldn't find the bug.  Without him the distribution of
  52. this  package  would  be  in  two or three months.  It's although late.  It
  53. would be distributed in early December if I hadn't had the problem. :(
  54.  
  55. ---------------------------------------------------------------------------
  56.   Contents
  57. ---------------------------------------------------------------------------
  58.  
  59.   1. MDC compared to DMS
  60.   2. Installation
  61.   3. Usage
  62.   4. How to register?
  63.   5. To do
  64.   6. History
  65.  
  66. ---------------------------------------------------------------------------
  67.   1. MDC compared to DMS
  68. ---------------------------------------------------------------------------
  69.  
  70.   Why should somebody use MDC rather than DMS?
  71.  
  72.   -x-  MDC  is  faster on slower machines than DMS.  On my 50 MHz 68030
  73. there is no difference.
  74.  
  75.   -*-  MDC  uses  more  different  packers  than DMS.  There are 16 packers
  76. supported  by  Xpk  at the moment and only 4 by DMS, where BEST, HEAVY1 and
  77. HEAVY2 use too much time for the compression.  Here are the test results:
  78.  
  79.   Please read the complete context while the board shows that DMS is faster
  80. in unpacking, but this is only usable if user is sure that the disk is 100%
  81. O.K.  In the context are some other important information too.
  82.  
  83.   Not  so  good  compression  with  MDC  acording  to  DMS is caused by not
  84. identifying  empty  tracks  by MDC.  Implementing it to MDC has the highest
  85. priority  at  the  To  Do  things.  Probably it would be better making this
  86. table  after  implementing it.  I stoped making the table when I discovered
  87. the difference.
  88.  
  89.                Disk 1              Disk 2   
  90.                DICE C V3.0 Disk 1  Workbench 3.0
  91.                Size   CR PT   UPT  Size   CR PT   UPT  PMemU  UPMemU
  92.  
  93.   DMS BEST     604392 33 1:41 1:41 385728 58 2:08 0:43 615864 439012
  94.   DMS HEAVY1   606119 33 2:19 1:43 393606 57 2:37 0:43 521952 438984
  95.   DMS HEAVY2   604392 33 2:13 1:40 385728 58 2:39 0:44 649000 439280
  96.   DMS NONE     902776  0 1:06 1:37 902776  0 0:55 0:42 ?????? 439280
  97.  
  98.   MDC BLZW.14  747236 18 0:58 0:50 656752 28 0:58 0:52  42160  40392
  99.   MDC BLZW.28  740580 18 1:00 0:51                      46016  41926
  100.   MDC BLZW.42  744740 18 1:01 0:50                      53792  46148
  101.   MDC BLZW.57  751188 17 1:00 0:49                      69200  54024
  102.   MDC BLZW.71  757304 16 0:59 0:49                      99776  70640
  103.   MDC BLZW.85  757304 16 0:57 0:49                     161216  71376
  104.   MDC BLZW.100 757304 16 0:59 0:48                     284080  70780
  105.  
  106.   MDC CBR0.100 727928 20 0:49 0:47 804284 11 0:50 0:47  38312  37176 
  107.  
  108.   MDC DLTA.100 906256  0 0:47 0:47 906256  0 0:47 0:47  38312  37176
  109.  
  110.   MDC FAST.79  696484 23 0:52 0:46 561624 38 0:51 0:46 103848  37880
  111.   MDC FAST.100 683740 25 1:54 0:46 508988 44 1:47 0:46 316840  37176
  112.  
  113.   MDC FEAL <-- Not usable with MDC, for now. CR = 0%. Password encyption.
  114.  
  115.   MDC HFMN.100 756408 17 1:01 1:00                      46008  44200
  116.  
  117.   MDC HUFF.100 771432 15 1:38 0:58                      67896 108488
  118.  
  119.   MDC IDEA <-- Not usable with MDC, for now. CR = 0%. Password encyption.
  120.  
  121.   MDC IMPL.10  688964 24 2:14 0:48                     301496  37736
  122.   MDC IMPL.30  631740 30 2:34 0:48                     308232  37880
  123.   MDC IMPL.50  624592 31 2:48 0:48                     309032  37800
  124.   MDC IMPL.75  620400 32 3:52 0:48                     327200  37800
  125.   MDC IMPL.98  619688 32 4:40 0:48                     343648  37720
  126.   MDC IMPL.100 619688 32 4:35 0:48                     343648  37800
  127.  
  128.   MDC MASH.100 617308 32 2:40 0:50                     234920  37800
  129.  
  130.   MDC NONE.100 905616  0 0:45 0:46                      37688  37096
  131.  
  132.   MDC NUKE.100 649464 28 1:10 0:47                     235008  37176
  133.  
  134.   MDC RAKE.25  658964 27 1:00 0:48                     191928  37684
  135.   MDC RAKE.50  658344 27 1:01 0:48                     191928  37684
  136.   MDC RAKE.75  657828 27 1:01 0:48                     191928  37684
  137.   MDC RAKE.100 657720 28 1:01 0:48                     191928  37684
  138.  
  139.   MDC RDCN.100 673148 26 0:55 0:47                      54668  37504
  140.  
  141.   MDC RLEN.100 721144 20 0:58 0:49                      38312  37176
  142.  
  143.   MDC SHRI.14  633996 30 6:17 5:19                      78344  40896
  144.   MDC SHRI.28  626608 31 6:16 5:11                      81416  41904
  145.   MDC SHRI.42  624404 31 6:24 5:09                      87560  43952
  146.   MDC SHRI.56  623176 32 6:36 5:17                      99848  48064
  147.   MDC SHRI.70  622652 31 6:38 5:09                     124424  56240
  148.   MDC SHRI.84  622652 31 6:39 5:12                     173576  72624
  149.   MDC SHRI.100 622652 31 6:49 5:10                     271880 105392
  150.  
  151.   MDC SMPL.100 772636 15 1:09 0:51                      52416  37800
  152.  
  153.   MDC SQSH.100 666948 26 2:10 0:49                     117592  37800
  154.  
  155.   In  tests  were  used  MDC68020 V1.16 Registered and DMS V2.01 Evaluation
  156. Copy.
  157.  
  158.   Configuration used in test:
  159.  
  160.   Amiga 1200
  161.   Kickstart 3.0
  162.   Workbench 3.1
  163.   3.5  ''  Hard Disk Quantum 240AT (Transfer rate:  1.25 MB/s.  Tested with
  164. SysInfo)
  165.  
  166.   All files were packed to hard disk.
  167.  
  168.   Please note: Dice C Disk 1 contains some packed files.
  169.  
  170.   The  number  after  pack method (FAST, NUKE,...) means the pack mode.  If
  171. there is only name.100, it means that there are no other modes.
  172.  
  173.   Size  and  Memory Usage are in bytes.  CR is compression ration in %.  PT
  174. is packing time, UPT is unpacking time.
  175.  
  176.   Memory  usage  is of course not precise but the results are maximal ±3 kB
  177. away from the precise number.
  178.  
  179.   Workbench 3.0 disk was unpacked with noverify but DMS didn't report error
  180. like  MDC  did  without  verify  implemented.   You  can  check this out by
  181. yourself.
  182.  
  183.   MDC without usage of Xpk library uses approximately 37 kB.  The number by
  184. Memory usage is the usage with the library.
  185.  
  186.   At   the   decompression  with  DMS  it's  important  to  know  that  its
  187. decompression to the disk is with verify, but its verify is not better than
  188. MDCs' which is simplier.
  189.  
  190.   DMS  V2.20  registered  crashed  once  (before starting the 2nd test with
  191. DMS),  when  I wanted to pack with CMODE HEAVY1, used DMS V2.02 instead.  I
  192. tested  DMS  if  it's going to crash again in the same cicumstances, and it
  193. crashed.
  194.  
  195.   -*-  MDC  itself  uses  only 37 kB.  DMS uses much more (it has all
  196. pack  methods  implemented) (about 600kB).  MDC With the packer, which uses
  197. at  least  memory, uses 38312 bytes with 20% compression ratio and MDC with
  198. the  packer,  which  uses  the  most  of memory, uses 343648 bytes with 32%
  199. compression ratio.
  200.  
  201.   -*-  If  you have a DMS file which has corrupted packed tracks, there are
  202. nearby  none  possibilities to unpack it.  Maybe it contains something what
  203. is  not  so  important.  MDC offers a possibility to unpack corrupted files
  204. because of it's file structure.
  205.  
  206.   -*-  According  to  this  that  MDC isn't finished yet, I can't tell more
  207. about  the  disadvantages  and advantages.  Please register and/or wait for
  208. the  next  version  of MDC.  I will get a turbo board tomorrow with 8 MB of
  209. RAM, so there won't be excuses for not continuing developing it.
  210.   
  211. ---------------------------------------------------------------------------
  212.   2. Installation
  213. ---------------------------------------------------------------------------
  214.  
  215.   You  should  have  Xpk  package  installed  (it's  on AmiNet in util/pack
  216. directory  named  xpk25usr.lha  or  later), then the only thing to do is to
  217. copy  the  version of MDC that works with your processor (68000 is for all,
  218. 68020 is for 68020, 68030, 68040 and 68060):
  219.  
  220.   Copy MDC680X0 C:MDC
  221.  
  222.   Where X is one of 2 or 0
  223.  
  224.   That's  it.  If you want to test it you don't have to read the doc to the
  225. end, but PLEASE NOTE (!) these facts for this unregistered version:
  226.  
  227.   -*-  It  doesn't  tell  you  to insert the disk to unpack or pack to.  It
  228. starts  to  do it so be careful (I am used to it, but there are some people
  229. who could have problems with it.
  230.  
  231. ---------------------------------------------------------------------------
  232.   3. Usage
  233. ---------------------------------------------------------------------------
  234.  
  235.   MDC From/A,To/K,Q=Quiet/S,L=Low/N/K,H=High/N/K,M=Mode/K/N,P=Packer/K,
  236.       Test/S,Info/S,Extract/S,Repack/S,Join/S,Beep/S,WFK=WaitForKey/S,
  237.       Verify/S,Corrupt/S,MDCOnly/S,Prefs/K
  238.  
  239.   Some examples:
  240.  
  241.   1.  MDC DF0:  To RAM:Test.MDC 0 0 M 100 P Nuke
  242.   2.  MDC DF0:  To RAM:Test.MDC Low 0 High 0 Packer Nuke Mode 100
  243.   3.  MDC RAM:Test.MDC Test
  244.   4.  MDC RAM:Test.MDC To DF1: Quiet
  245.  
  246.   Examples  1 and 2 are the same.  Both are packing track 0 of disk in DF0:
  247. to file RAM:Test.MDC with packer Nuke and mode 100.
  248.   Example 3 tests archive RAM:Test.MDC if it is corrupt or not.
  249.   Example 4 unpakcs archive RAM:Test.MDC to DF1:  Nothing is printed to the
  250. output.
  251.  
  252.   From/A - It can be file or DFx:.  It can be file only if To/K is DFx:  or
  253. one  of  following  options  is  used:   Test/S, Info/S, Split/S, Repack/S,
  254. Join/s.   And  it  can  be  DFx:  if To/K is file or none of before written
  255. options  is used.  If this argument is DFx:, MDC will pack to To/K. If this
  256. argument is file, MDC will unpack it from From/K to To/K.
  257.  
  258.   To/A - See the context at From/K. It can be file if From/A is DFx:.
  259.  
  260.   Q=Quiet/S - This argument causes MDC not to print anything to the output.
  261. The  only  things printed to the output are errors.  Options Info/S, Test/S
  262. and WaitForKey/S disable this option.
  263.  
  264.   L=Low/N/K  - It can be a number between 0 and 79 (by now).  It stands for
  265. the low track to be packed.  There is no affection on unpacking by now.
  266.  
  267.   H=High/N/K - It can be a number between 0 and 79 and has to be greater or
  268. equal than L=Low/N/K.  If only one of H=High/N/K or L=Low/N/K is given, MDC
  269. uses the default value for the other.
  270.  
  271.   M=Mode/K  -  It  can  be  a number between 0 and 100.  It represents pack
  272. mode.  It has no affection on unpacking.
  273.  
  274.   P=Packer/K  - It can be a packer of the Xpk package except IDEA and FEAL.
  275. It represents packer method.  It has no affection on unpacking.
  276.  
  277.   Test/S  -  It tests the archive.  If there is only one error it stops and
  278. reports it. If there is everything O.K. it prints that file is O.K.
  279.  
  280.   Info/S - Displays a short information about the archive.
  281.  
  282.   Extract/S  -  it extracts some packed tracks from the archive.  From/A is
  283. the name of the archive, To/K is the name of the new, extracted archive and
  284. low and high are the first and the last number of the tracks to extract.
  285.  
  286.   Repack/S  - The same as extract, only that Packer and Mode have affection
  287. to it and it repacks the archive to new one and not only extracts.
  288.  
  289.   Join/S  -  It  joins  extracted archives.  It doesn't matter if there are
  290. some  tracks not available.  It only matters if the disk with this unpacked
  291. archive will function like it should.
  292.  
  293.   Beep/S  -  It  causes  the program to beep after finishing his job, since
  294. there  are  some people who watch TV during the long operations and want to
  295. know if the processing is finished without to have a look to the monitor or
  296. drive LEDs.
  297.  
  298.   WFK=WaitForKey/S  -  It  is  for the people, who want to start operations
  299. direct  after  typing  the  command  and pressing return, like me.  And not
  300. being bored with the request:  Do this and that and pres whatever.
  301.  
  302.   Verify/S  -  I  think it's a little bit useless, but there are people who
  303. want  to be sure.  The only thing what it is doing more than without it, is
  304. that,  when  reading  from  disk,  it  is reading twice to different memory
  305. locations and comparing them. Similiar to this is writing to disk. 
  306.  
  307.   Corrupt/S  -  It  unpacks  corrupted  archives  as  best as possible.  It
  308. unpacks  files  which  were  packed  from  track 0 to 39 in one archive and
  309. packed  from  track  40  to  79 (for example) to the other archive and then
  310. joined  with AOS join command.  But I think the last possibility won't have
  311. much sense after implementing the Join option.
  312.  
  313.   MDCOnly/S  -  affects  only searching files with a pattern.  If it's set,
  314. MDC  will  search  only  #?.MDC  files.  Otherwise it will get all files no
  315. matter if they are with MDC extension or not.
  316.  
  317.   Prefs/K  -  it has an file, for argument, which contains the settings for
  318. the program.
  319.  
  320. ---------------------------------------------------------------------------
  321.   4. How To Register?
  322. ---------------------------------------------------------------------------
  323.  
  324.   The registration costs 10 Deutsche Mark, 4 Pounds Sterling, 8 US Dollars,
  325. 10   Austraian  dollars,  70  Oesterreichische  Schilling,  800  Slovenskih
  326. Tolarjev  or  8  Schweizerische Franken.  That are all currenties which are
  327. accepted.  Any other won't be accepted and won't be sent back and you won't
  328. become a registered user.
  329.  
  330.   I think it's worth it, not now, but as though I am going to do the planed
  331. things.
  332.  
  333.   You  can  send  me  the  money via mail (not E-Mail :) ).  All registered
  334. users  will  get  the  newest version of MDC sent via E-Mail or on from you
  335. sent disk.
  336.  
  337. ---------------------------------------------------------------------------
  338. 5. To Do
  339. ---------------------------------------------------------------------------
  340.  
  341.   -*-  Make  him  not to pack the empty tracks.  Serious problem!  I didn't
  342. realize  it,  before  making  the  complete  test  with  DMS and DMC in MDC
  343. compared to DMS.
  344.  
  345.   -*-  Verification.  It makes a simple verification but it doesn't compare
  346. the data read from disk or written to it.
  347.  
  348.   -*-  It  still  not  unpack  corrupt  archives.  Please see the Usage for
  349. further explainations.
  350.  
  351.   -*-   Repack   isn't   done  yet.   Please  see  the  Usage  for  further
  352. explainations.
  353.  
  354.   -*-   Extract   isn't  done  yet.   Please  see  the  Usage  for  further
  355. explainations.
  356.  
  357.   -*- Join isn't done yet.  Please see the Usage for further explainations.
  358.  
  359.   -*- WaitForKey isn't done yet. Not much work to do.
  360.  
  361.   -*- Beep isn't done yet. Not much work to do.
  362.  
  363.   -*- Info isn't done yet. Not much work to do.
  364.  
  365.   -*- Prefs isn't done yet.  I haven't planed it yet.  It's only an idea at
  366. the moment.
  367.  
  368.   -*-  Searching  archives  with  wildcard  isn't done yet.  For testing or
  369. maybe  for  unpacking  too, would be great when the user could write MDC #?
  370. test.
  371.  
  372.   -*-  MDCOnly  isn't done yet.  There won't be much work to do after doing
  373. the previous To Do.
  374.  
  375.   -*-  It  doesn't  check if the to file is existant or not.  It overwrites
  376. it, if it exists and creates new if it doesn't.
  377.  
  378.   -*-  If  the disk is full, to which a disk is packed it reports only that
  379. there is error but not which. Not much work to do this.
  380.  
  381.   -*-  Controlling of CTRL C.  There is no possibility to break the program
  382. (exept  reset  or turning off the computer).  It worked fine, but I removed
  383. it (don't ask me why). Will be implemented in the next released version.
  384.  
  385.   -*-  Better  output on the end of processing.  There is an ugly output at
  386. the moment.  I am about to make a new one which would look prettier:
  387.  
  388.        Estimate time:     1:41
  389.        Tracks:            60
  390.        Empty tracks:      20
  391.        Size:              647236 bytes
  392.        Compression ratio: 37%
  393.  
  394.   -*- Password encryption if it is needed. I haven't used it till now.
  395.  
  396.   -*- I could modify the track header produced by Xpk.  There is some data,
  397. which is always the same.  That would make MDC archives shorter (I know how
  398. to eliminate about 11 long words per track, minimal >= 80*11*4 = 3520 bytes
  399. shorter  archive).   But that would make new archives uncompatible with the
  400. old. But compatibility won't take that much memory usages (6 LW).
  401.  
  402.   If  you  think  there  is something that could be done in addition to the
  403. above, tell me about it.  All suggestions are welcome.
  404.  
  405. ---------------------------------------------------------------------------
  406. 6. History
  407. ---------------------------------------------------------------------------
  408.  
  409.   I  don't have enough time to write it.  Besides I don't even know if it's
  410. worth  doing  it,  because  since 68030 machines will rule this world there
  411. won't be need for a program like mine it is.
  412.  
  413. ---------------------------------------------------------------------------
  414.