home *** CD-ROM | disk | FTP | other *** search
/ Computer Installation Guide - Dragon Clan Series / CD2.iso / ZIP / WWPACK / WWP304 / ENHANCED / WWPACK.DOC
Encoding:
Text File  |  1996-01-05  |  21.2 KB  |  553 lines

  1.  
  2.  
  3.         WWPACK 3.04   a powerful executable file compressor for DOS
  4.  
  5.         Copyright (c) 1993-96 by Piotr Warezak and Rafal Wierzbicki
  6.  
  7.         6 January 1996   Lodz, Poland           All Rights Reserved
  8.  
  9.  
  10.  
  11.       We are happy to provide our e-mail addresses.  Please feel free
  12.          to inform us of any problems at the following addresses.
  13.  
  14.                            Authors:  awarezak@krysia.uni.lodz.pl
  15.  
  16.               American distributor:  gjereza@crl.com
  17.  
  18.                 German distributor:  support@vgasoft.com
  19.  
  20.  
  21.  
  22.        The latest shareware version of WWPACK can always be found on:
  23.  
  24.            o  Slovak Antivirus Center:
  25.               ftp.elf.stuba.sk    /pub/pc/pack
  26.  
  27.            o  SimTel mirrors, directory  /SimTel/msdos/execomp
  28.               (eg.  oak.oakland.edu  or  ftp.cyf-kr.edu.pl)
  29.  
  30.            o  The ClipBoard BBS
  31.               (415) 293 0454
  32.               8N1  2400-28800bps
  33.               24 hours, San Francisco
  34.  
  35.            o  WWPACK is FREQable (file requestable) from
  36.               The ClipBoard BBS,
  37.               FidoNet 1:125/454
  38.               The magic name is WWPACK.
  39.  
  40.            o  VGA-Copy Headquarters BBS
  41.               +49-441-972955
  42.               8N1  USRobotics V34
  43.               24 hours, Germany
  44.  
  45.            o  WWPACK is file requestable from
  46.               VGA-Copy Headquarters,
  47.               FidoNet 2:2426/2240
  48.               The magic name is WWPACK.
  49.  
  50.            o  ftp-mailserver:  fileserv@vgasoft.com
  51.  
  52.  
  53.  
  54. *** This version of WWPACK must be registered,and requires the WWPACK.REG
  55. *** key file created specifically for you.
  56. *** The  WWPACK.REG  file can not be  distributed, sent, rented, changed,
  57. *** hacked, or reversed engineered in any way. Any attempts to do so will
  58. *** automatically terminate the license!
  59.  
  60. *** The original  version WWPACK is distributed in  the ZIP file  containing
  61. *** WWP304.EXE RAR 1.55 SFX archive with Authenticy Verification information
  62. *** "by Piotr Warezak and Rafal Wierzbicki".
  63.  
  64.  
  65.  
  66. WHAT IS A WWPACK?
  67.  
  68.   WWPACK is a powerful EXE file compressor. This program compresses most
  69.   DOS executable files. Compressed programs use less disk space because
  70.   they are much smaller. All files run EXACTLY as before.
  71.  
  72.  
  73. REQUIREMENTS TO RUN WWPACK.
  74.  
  75.   WWPACK works on any machine with about 450Kb free DOS memory. Remember that
  76.   the faster machine you use the less time you need to compress an EXE file.
  77.  
  78. Requirements to run EXE files compressed with WWPACK.
  79.  
  80.   A file compressed with WWPACK will run on IBM or compatible based systems
  81.   like the XT, AT, 80286, 80386, 80486, Pentiums, laptops, and palmtops
  82.   (eg. the Hewlett Packard HP95LX).  DOS 2.0 or higher is required.
  83.  
  84.  
  85. WWPACK'S COMMANDS  -  to get a very short help type:  WWPACK /?
  86.  
  87.   To pack an EXE file enter:
  88.       WWPACK FILENAME.EXE
  89.   or  WWPACK P FILENAME.EXE
  90.   When complete, the file will be smaller and work as before.
  91.   The packing process can be interrupted by using the CTRL+Break keys.
  92.  
  93.   To pack a relocation table enter:  WWPACK PR FILENAME.EXE
  94.   To create an unextractable and encrypted (!) file use this command:
  95.       WWPACK PU FILENAME.EXE
  96.   Warning: this procedure cannot be reversed!
  97.   This command should be used only on files that you want to distribute.
  98.  
  99.   To protect a file with a password type:
  100.       WWPACK PP FILENAME.EXE
  101.   WWPACK will ask you for a password which you must enter twice. The password
  102.   must be from four to nine characters long and is NOT case sensitive.
  103.   Warning: if you forget your run-password your file will be unusable!
  104.  
  105.   To unpack an EXE file enter:
  106.       WWPACK U FILENAME.
  107.   Remember that the file you want to process with this command must be already
  108.   compressed with WWPACK!
  109.  
  110.   (Note that the 'U' command can't decompress files created with the 'PU'
  111.   command).
  112.  
  113.  
  114.   TESTING EXE FILES.
  115.  
  116.     Command 'T' lets you see if the file is already compressed by any
  117.     executable file compressor. WWPACK recognizes files compressed by LZEXE,
  118.     PKLITE and many many other compressors.
  119.     Usage:  WWPACK T FILENAME.EXE
  120.     Additional command  WWPACK T  checks automatically all EXE files stored
  121.     in the current directory.
  122.  
  123.   OPTIMIZING HEADERS.
  124.  
  125.     If you want to optimize a header of an EXE file use:
  126.         WWPACK O FILENAME.EXE
  127.     Sometimes the header can be a bit shorter but in most cases nothing will
  128.     change.
  129.  
  130.   ADDITIONAL COMMANDS: 'PD' and 'UD'.
  131.  
  132.     WWPACK has two commands that you can use on any file you want:
  133.     'PD' and 'UD'  (pack data and unpack data).
  134.  
  135.     Command 'PD' will pack a data file.
  136.     Example:  WWPACK PD PROGRAM.DAT
  137.  
  138.     Command 'UD' will unpack any file packed with 'PD'.
  139.     Example:  WWPACK UD PROGRAM.DAT
  140.  
  141.     Note: Normally, a packed data file is unusable. Therefore, you must first
  142.     unpack it (ie  'PD' and 'UD' options are similar to PKZIP's 'a' and 'e'
  143.     commands).
  144.     Please see the WWPACK Pascal Support procedures for info how to use
  145.     WWPACKed data files in your programs. With our TPU files, you can read
  146.     WWPACKed files and decompress them directly to memory!
  147.  
  148.  
  149. CAN I USE WILDCARDS?
  150.  
  151.   Sure! WWPACK lets you to use '*' and '?' in every command.
  152.  
  153.   Examples:
  154.     to compress all EXE files in the current directory just type:
  155.        WWPACK P *.EXE
  156.  
  157.     to optimize headers of all EXE files type:
  158.        WWPACK O *.EXE
  159.  
  160.     to pack all files (as data) enter this command:
  161.        WWPACK PD *.*
  162.  
  163. CAN I USE PATHS?
  164.  
  165.   Of course you can!
  166.  
  167.   Example:
  168.     command  WWPACK P C:\UTILITY\TEST.EXE  will compress TEST.EXE file stored
  169.     in C:\UTILITY directory.
  170.  
  171.  
  172. CONFIGURATION MENU.
  173.  
  174.   We wanted to make WWPACK easy to use. You don't have to remember any
  175.   options because you can set everything in a special configuration menu.
  176.  
  177.   To configure the program enter:  WWPACK C.  Now use number keys to set some
  178.   useful options.
  179.   1  -  do you want WWPACK to make backup files?
  180.         Select 'ON' and you will always get OLD and OLP files.
  181.         (There are two exceptions: WWPACK always makes backups when 'PP'
  182.          command is used or when the file packed with the 'PP' command is
  183.          being unpacked).
  184.   2  -  select 'ON' if you want to get more information about every file
  185.         that is being compressed.
  186.   3  -  please select 'ON' if you want to compress files with overlays or
  187.         'OFF' if you don't want to compress such a files. If you choose 'ASK'
  188.         WWPACK will always ask you if the file should be compressed or not.
  189.   4  -  select 'ON' if you want WWPACK to compress already compressed files.
  190.   5  -  sometimes WWPACK is slow, so selecting 'ON' is a good idea.
  191.   6  -  select 'ON' to use 'Smart unpacking'. This option tells WWPACK to
  192.         copy .OLD or .OLP file to .EXE instead of the normal unpacking when
  193.         possible (this way unpacking is much faster).
  194.   7  -  use this option to select an "unextractable compression method":
  195.         SOFT - to create files unextractable with WWPACK
  196.         HARD - to create files unextractable not only by WWPACK but with
  197.                many other intelligent unpackers (we tried CUP 1.2, UUP 1.4,
  198.                TRON 1.21+ Shareware and many other decompression programs -
  199.                all failed to extract the code!)
  200.  
  201.   When you set all options, press 'S' key to save them or 'ESC' to exit
  202.   without saving. You may use the 'T' key to set the default configuration.
  203.  
  204.  
  205. PARAMETERS AND SWITCHES.
  206.  
  207.   Here is list of parameters that you may use while working with WWPACK:
  208.  
  209.   -adv  use advanced mode
  210.   -b-   tells WWPACK not to make backup files
  211.   -b+   always make backups (OLD and OLP files)
  212.   -d    compressed files will run before specified day (this option can be
  213.         used only with 'PU' compression method)
  214.   -o-   don't pack files with overlays
  215.   -o+   always pack files with overlays
  216.   -p-   don't pack already packed files
  217.   -p+   pack already packed files
  218.   -t    ask for a text that the file packed with -d option will show when
  219.         the run date is exceeded
  220.   -us   use unextractable SOFT compression method (with 'PU' command only)
  221.   -uh   use unextractable HARD compression method
  222.   -y    assume 'YES' on all queries (WWPACK will proces automatcally all
  223.         files)
  224.  
  225.   Example:
  226.      WWPACK P -B- -O+ -Y MYPROG.EXE
  227.   means: pack MYPROG.EXE file; don't make backup; pack even if the file
  228.   contains an overlay. Process automatically the file (no questions while
  229.   packing).
  230.  
  231.  
  232. PACKING FILES FROM THE LIST FILE.
  233.  
  234.   A special option:  -@FileName  lets you to process only selected files.
  235.   To pack only a few files from the current directory, you can create
  236.   a special file, for example:  WWPACK.LST  (name of this file is not
  237.   important). This file should contain the names of all files you want to
  238.   process. Every name should begin from a new line. There musn't be any
  239.   free lines in the list file!
  240.  
  241.   Here is an example of a list file:
  242.     --- cut here ---
  243.     MYFILE.EXE
  244.     ANYFILE.EXE
  245.     anotHer.EXE
  246.     --- cut here ---
  247.   This small file tells WWPACK to process only three files. All other files
  248.   from the current directory will be skipped.
  249.   To use this list file type:
  250.      WWPACK P -@WWPACK.LST
  251.  
  252.   Note, that wildcards and paths aren't allowed in the list file!
  253.  
  254.  
  255. BACKUP FILES.
  256.  
  257.   Not every EXE file can be compressed with WWPACK. That's why this program
  258.   creates backups. In case of problems you can restore the original file.
  259.  
  260.   Remember:
  261.     Original FILENAME.EXE file is always renamed to FILENAME.OLD file
  262.     while compressing or optimizing, and to FILENAME.OLP when decompressing.
  263.  
  264.   HINT:
  265.     If you forgot to make a backup while compressing an EXE file, try
  266.     undeleting or unerasing it!
  267.  
  268.  
  269. FILES THAT CAN'T BE PACKED.
  270.  
  271.   Some files can't be compressed with WWPACK.
  272.  
  273.   o  programs that check the CRC of a file
  274.   o  files that store configuration data internally
  275.   o  drivers that can be loaded in a config.sys file
  276.   o  some files with overlays
  277.   o  Windows and OS/2 files ('NE' and 'LE' programs)
  278.   o  some COM files (COM file may not work after conversion to EXE format)
  279.   o  files that contain more than 15000 relocation entries
  280.  
  281.   Some files are automatically recognized by WWPACK. But sometimes it's
  282.   impossible to predict if the file can be compressed. You just have to
  283.   check every compressed EXE file!
  284.  
  285.  
  286. CRC MODULE: "Be sure that the file isn't damaged"
  287.  
  288.   WWPACK uses special module that adds CRC code to EVERY compressed EXE file.
  289.   This unique technology lets you to check if any WWPACKed EXE file has been
  290.   damaged or infected by a virus.
  291.  
  292.   To check files you may use WWVIR or CRC program.
  293.  
  294.   HINTS FOR PROGRAMMERS:
  295.   o You may freely add CRC program to your commercial and noncommercial
  296.     products. It's public domain!  (However, you must have the enhanced
  297.     version of WWPACK to distribute WWPACKed programs)
  298.   o CRC module checks almost EVERY byte of compressed EXE file: from the
  299.     beginning ('MZ' signature) to the very end.
  300.     Warning: CRC module doesn't check overlays!
  301.   o There are six bytes in the compressed EXE file that you can freely change.
  302.     The area in $1A to $1F bytes is not protected with the CRC module, so you
  303.     can store configuration or any data here.
  304.   o Please see WWPACK Pascal Support for CRC.TPU unit.
  305.  
  306.  
  307. ERRORS AND OTHER MESSAGES.
  308.  
  309.   WWPACK is quite an intelligent program and sometimes it may show some kind
  310.   of an error message. But don't worry. Just read the comment and you will
  311.   find an explanation for the problem (WWPACK has almost 30 error messages!).
  312.  
  313.   From time to time you may see some question also (it depends on a
  314.   configuration that you have chosen).
  315.  
  316.   Here is a list of important questions and messages that you may meet when
  317.   working with WWPACK:
  318.  
  319.    CRC status: OK
  320.      File CRC is OK. It means that the file is not damaged nor infected by
  321.      a virus. This massage appears while unpacking the file packed with
  322.      WWPACK version 3.03 or 3.04.
  323.  
  324.    Delete FILENAME file to make a new backup file [Y/n]?
  325.      WWPACK must know if the old backup file can be deleted. Press 'Y' key
  326.      to continue processing or 'N' to quit (and save an old backup).
  327.  
  328.    Enter date limit (dd-mm-yy):
  329.      Type the date that the packed file will not work after.
  330.      For example: 01-02-97 tells WWPACK to create the file that will not
  331.      work after the 1st february 1997.
  332.  
  333.    Enter date limit text:
  334.      Type the text, that you want to be shown by the packed file when
  335.      the date limit is exceeded. The text must not exceed 55 characters!
  336.  
  337.    Enter password:
  338.      This message appears when the 'PP' or 'U' command is used. Please enter
  339.      the password required to run the packed file ('PP' command) or enter the
  340.      password required to unpack the compressed file ('U' command).
  341.  
  342.    File not processed.
  343.      You didn't let WWPACK process the file (for example you didn't let
  344.      WWPACK delete an old backup file).
  345.  
  346.    Relocation table is already packed.
  347.      You can't use 'PR' command because the relocation table is already
  348.      packed. Please try the 'P' command to get a higher compression ratio.
  349.  
  350.    The file FILENAME has set attribute READ ONLY. Change file attribute [Y/n]?
  351.      The file has set the READ ONLY attribute. To process it the attribute
  352.      must be deleted. Press 'Y' key to continue packing or 'N' to stop WWPACK.
  353.  
  354.    The file contains Debug_Info. Do you want to remove it [Y/n]?
  355.      The file contains some data that aren't required by a program. These
  356.      data can be removed - the file will be much shorter. Press 'Y' if you
  357.      want WWPACK to remove Debug_Info or 'N' to process the file without
  358.      removing it.
  359.  
  360.    The file size stored in the header is bigger then the real file size.
  361.    The processed file may not work. Continue [Y/n]?
  362.      The file is probably damaged but you may want WWPACK to pack it.
  363.      This message is rarely seen.
  364.  
  365.    Warning: bad CRC. File probably damaged.
  366.      The file that is being unpacked is damaged. It may not work after
  367.      decompression!
  368.  
  369.    Warning: the file contains an overlay XXX bytes. Continue [Y/n/r]?
  370.      The file that you want to process contains an overlay. Press 'Y' to pack
  371.      or optimize the file or 'N' if you don't want to process it. Press 'R'
  372.      to remove an overlay and then process the file (not recommended really).
  373.  
  374.    Warning: the file is already packed with ....
  375.    Do you want to pack it [Y/n]?
  376.      The file is already packed but WWPACK may try to pack it.
  377.      Press 'Y' if you want WWPACK to process the file or 'N' to quit.
  378.  
  379.    Warning: there are some identical relocation entries.
  380.      This message shows that the file may not work after compression because
  381.      the relocation table contains incorrect data.
  382.  
  383.    Warning: this is COM file. Convert it to EXE format [Y/n]?
  384.      The file you want to process is not an EXE. Press 'Y' if you want to
  385.      convert it to EXE format or 'N' to quit.
  386.  
  387.  
  388.   Note that you must select between Yes or No. Pressing the Enter key alone
  389.   will always select the default answer.
  390.  
  391.  
  392. HOW DOES WWPACK WORK?
  393.  
  394.   First it compresses EXE file; then it adds a small extract code. When you
  395.   load the packed file into memory, the computer first runs this extract 
  396.   code and then the unpacked program.
  397.  
  398.   It's simple, isn't it?
  399.  
  400.  
  401. HOW DOES WWPACK COMPARE TO THE OTHER COMPRESSORS?
  402.  
  403.   Read this short table and compare:
  404.   (Note: All sizes are in bytes)
  405.  
  406.                      qp.exe       ncmain.exe    ndd.exe       total size
  407.       Unpacked       86,842       212,393       383,874       683,109
  408.  
  409.       TINYPROG       53,520       117,632       225,440       396,592
  410.       LZEXE          52,983       116,980       224,646       394,609
  411.       PKLITE         52,289       115,354       222,995       390,638
  412.       DIET           52,694       116,044       220,799       389,527
  413.       AVPACK         51,943       113,252       217,622       382,817
  414.       AINEXE         51,534       111,350       210,955       373,839
  415.       COMPACK        51,052       111,180       210,956       373,188
  416.       JAM            51,204       109,556       208,292       369,052
  417.       UCEXE          51,053       109,157       205,557       365,767
  418.       WWPACK         49,787       106,209       200,293       356,289
  419.  
  420.       To make this comparison we used these popular shareware programs:
  421.       AINEXE 2.1 by Transas Marine Ltd.
  422.       AVPACK 1.22 by Andrei Volkov
  423.       COMPACK 4.5 by W.J. Collis
  424.       DIET 1.45 by Teddy Matsumoto
  425.       JAM 2.11 bu Eugen Vasilchenko
  426.       LZEXE 0.91 by Fabrice Bellard
  427.       PKLITE 1.50 by PKWARE
  428.       TINYPROG 3.9 by Tranzoa, Co.
  429.       UCEXE 2.4 by Ad Infinitum Programs
  430.       and of course our WWPACK 3.04 with 'P' command.
  431.  
  432.       List of files we used to compress:
  433.       QP.EXE (Quattro pro 4.0),
  434.       NCMAIN.EXE (Norton Commander 4.0),
  435.       NDD.EXE (Norton Utility 8.0).
  436.  
  437.   Is WWPACK very powerful?  Try it and find out!
  438.  
  439.  
  440. FREQUENTLY ASKED QUESTIONS
  441.  
  442.   Q: Can I use WWPACK instead of PKZIP or RAR?
  443.   A: No. With PKZIP or RAR you can pack all kinds of files but you can't
  444.      normally use the packed programs.
  445.      With WWPACK you can compress only EXE files, however, they will still
  446.      run normally!
  447.      So the best way is to use two compression programs: first use WWPACK
  448.      on all EXE files and then use RAR or PKZIP.
  449.  
  450.   Q: Does WWPACK work with Stacker and DoubleSpace?
  451.   A: Sure. We have tested WWPACK with those programs and everything has
  452.      worked correctly. What's more you will have more space on the stacked
  453.      drive when you compress all your EXE files.
  454.  
  455.   Q: Is it possible to detect a virus in a compressed file?
  456.   A: No. You can't check if there is a virus under the WWPACK's code.
  457.      That's why everytime you compress some files you must be sure that
  458.      they are virus free!
  459.  
  460.   Q: Can I run DOS compressed files under Windows 3.1 and Windows 95?
  461.   A: Sure. You can use Windows or DOS.
  462.  
  463.   Q: Why is the compression ratio of 'PR' so poor?
  464.   A: It isn't poor. This command compresses only relocation tables.
  465.  
  466.   Q: What's the relocation table?
  467.   A: It's a part of an EXE file. It contains special data that are needed
  468.      to load and then execute program.
  469.  
  470.   Q: Why can't some overlaid files be compressed?
  471.   A: Because when you compress such a file the overlay offset changes
  472.      and the compressed program may not find an overlay.
  473.  
  474.   Q: Can I decompress an EXE file compressed with the 'PP' command?
  475.   A: Sure, but you must know the password.
  476.      To decompress the file, enter:  WWPACK U FILENAME.EXE
  477.      Enter a password and wait momentarily. The file will be unpacked!
  478.  
  479.   Q: I want to create a program that will show if the EXE file is already
  480.      compressed. How can I check if it's packed with WWPACK?
  481.   A: Please see our WWPACK Pascal Support package (\PASCAL directory).
  482.      With our functions and units you will not only recognize WWPACKed
  483.      EXE files. We gives you procedures, that will let you scan WWPACKed
  484.      files for viruses! Please see our examples and CRC source code for
  485.      complete information about how to use Pascal Support units.
  486.  
  487.  
  488. HINTS
  489.  
  490.   o  If you want to compress the file that is already packed with EXEPACK
  491.      you should first unpack it. You will get a higher compression ratio.
  492.   o  Always make backups (especially when you compress files with overlays).
  493.      Why? To make WWPACK much safer.
  494.   o  Allow WWPACK to remove Debug_Info.
  495.      The file without Debug_Info can be up to 10% smaller.
  496.  
  497.  
  498. Here are some words about us (authors):
  499.  
  500.   We are twenty. We are students of the University of Lodz. Piotr studies
  501.   computers (second year). Rafal is a student of International Economical
  502.   and Political Relations (second year also).
  503.  
  504.   We will improve our program because we like it and it gives us great
  505.   satisfaction. That's why we are waiting for your suggestions.
  506.  
  507. We would like to thank these people for their suggestions and beta-testing:
  508. Thank you!
  509.  
  510.   Marcel Barbulescu & Cristi Bradiceanu (The DOP), Peter Hubinsky (Slovak
  511.   Antivirus Center), George Jereza (The ClipBoard BBS), Karl Loncarek,
  512.   Piotr Kuciel, Thomas Monkemeier (VGA Software GmbH), Konrad Olejnik,
  513.   Ralph Roth (ROSE), Grzegorz Zgondek and Romuald Zylla.
  514.  
  515. We would like to thank to all people, who have tried earlier versions of
  516. WWPACK, especially to all registered users of WWPACK.
  517.  
  518.  
  519. WWPACK'S CODE INFORMATION:
  520.   written in
  521.     Turbo Pascal, ver. 7.0   (source code: 3690 lines)
  522.     assembler 8088   (1478 lines)
  523.   utility package and WWPACK Shell:
  524.     written in Turbo Pascal 7.0   (6219 lines)
  525. Software we used to create WWPACK:
  526.   Borland Pascal 7.0, Turbo Assembler 3.2, Turbo Debugger 3.2
  527.     by Borland International
  528.   DocGen II, FileTime 0.1, FTC 2.1, Perfidious 1.0  by Piotr Warezak
  529.   EatMem 1.1c  by TifaWARE
  530.   HackStop 1.11  by Ralph Roth - ROSE
  531.   RAR archiver 1.55  by Eugene Roshal
  532.  
  533.  
  534. UPGRADE INFO.
  535.  
  536.     Thanks for registering.
  537.     Are you interested in a new version of our program? Great!
  538.  
  539.   How can I get the newest version?
  540.  
  541.     Wherever you find a newer downloadable version of WWPACK.
  542.  
  543.   Is that all?
  544.  
  545.     Sure! The WWPACK.REG file will work with new versions of WWPACK.
  546.     See the top of this file to find out where WWPACK can be found!
  547.  
  548.  
  549. All programs mentioned in this documentation are trademarks of their
  550. respective owners. They're used for identification purposes only.
  551.  
  552. End of the WWPACK documentation file.
  553.