home *** CD-ROM | disk | FTP | other *** search
/ Hacks & Cracks / Hacks_and_Cracks.iso / vol1 / ucf-xpb3.zip / XPACK.DOC < prev    next >
Text File  |  1997-01-02  |  18KB  |  431 lines
  1.  
  2.  
  3.      XPACK    An Executable, Datafile... and DiskImage Compressor
  4.  
  5.      Copyright (c) 1995-1996 by JauMing Tseng
  6.  
  7.    WHAT IS XPACK?
  8.  
  9.      XPACK is an EXE/COM/SYS Executable file compressor. This program
  10.      compresses most DOS executable files. Compressed programs use
  11.      less disk space because they are much smaller,
  12.      yet they run EXACTLY as before.
  13.  
  14.     XPACK also allows a compressed diskette image to be created for
  15.     electronic transmission.  The compressed diskette image can be
  16.     transmitted with the use of a modem on regular phone line, or any
  17.     other electronic networks. It can be used to archive diskette
  18.     images on hard drives or tapes. This guarantees the contents of
  19.     the diskette to be the same as the original -- including all
  20.     directory structures, date and time stamps of all the files and
  21.     directories. This is useful for archiving bootable diskettes, too.
  22.  
  23.      XPACK is also a powerful file compressor with RAM resident
  24.      transparent expander(XPACK OnLine DeCompression System), which
  25.      gives painless access to compressed files. This is done by
  26.      intercepting DOS calls, allowing applications to read compressed
  27.      files just as before. Just put a command(XPACK -z) to load
  28.      XPACK into the AUTOEXEC.BAT file and forget it.
  29.  
  30.      The RAM resident part of XPACK OnLine DeCompression System uses
  31.      3KB of Upper memory and 32KB of EMS memory.
  32.  
  33.    SYSTEM REQUIREMENTS.
  34.  
  35.      XPACK works on any IBM-compatible machine with 192Kb of free
  36.      DOS memory.
  37.  
  38.      method 4 need extra 192Kb,
  39.      method 5 need extra 147kb for compression
  40.  
  41.      Every file compressed with XPACK can run on any IBM compatible
  42.      system: XT, AT, 80286, 80386, 80486, Pentium or Pentium Pro;
  43.      on Intel and non-Intel.
  44.  
  45.    USING XPACK.
  46.  
  47.      Enter the command:   XPACK [options] filename
  48.  
  49.       where "filename" is the name of the Executable file to be compressed.
  50.       XPACK will only work properly on Executable files, so if you do not
  51.       type a file extension, ".EXE", ".COM" or ".SYS" is assumed.
  52.       The filename can include drive and path specifications
  53.       and wildcards (* or ?).
  54.       The various "options" are explained later.
  55.  
  56.      XPACK will make an Executable file that:
  57.        (a) is smaller than the original, and
  58.        (b) works as before, without any noticeable loss of speed.
  59.  
  60.      The computer may take several seconds to do the compressing. If
  61.      you are impatient you can interrupt the process by pressing the
  62.      ESC key.
  63.  
  64.     Not every .EXE file can be compressed with XPACK.
  65.     (e.g. .EXE with internal overlay can only be packed with option /g)
  66.     That's why this program creates backups. The original FILENAME.EXE file
  67.     is renamed to FILENAME.OLE. If anything goes wrong you can
  68.     restore the original file by entering these 2 commands at
  69.     the DOS prompt:
  70.                       COPY FILENAME.OLE FILENAME.EXE
  71.                       DEL FILENAME.OLE
  72.      (.COM and .SYS files are always packed ok.)
  73.  
  74.    OPTIONS.
  75.  
  76.      Any "options" that you use are typed after "XPACK" and
  77.      before "FILENAME".
  78.  
  79.      Options are all case-insensitive, separated by spaces, and begin
  80.      with either the hyphen ('-') or the slash ('/') character.
  81.  
  82.      Here are the details of the command line options:
  83.  
  84.         -?  This switch invokes option -h
  85.  
  86.         -h  This switch tells XPACK to display a
  87.             Help Screen to the DOS console device.
  88.  
  89.                You can use "XPACK /? > XPACK.HLP" to save it.
  90.  
  91.         -4  This switch tells XPACK to use pack method 4
  92.             best ratio
  93.  
  94.         -5  This switch tells XPACK to use pack method 5 (default)
  95.             2nd compression ratio
  96.             fastest compression
  97.             quickest extraction
  98.             smallest sfx
  99.  
  100.         -x  expand a compressed .COM or .SYS file.
  101.  
  102.         -f  This switch tells XPACK to convert the file even if
  103.             the result is bigger than the original file. (Not many
  104.             users will take advantage of this option!)
  105.  
  106.         -o  This switch tells XPACK to override the default
  107.             generation of FILENAME.OLE backup files. (Use this only
  108.             if you have already determined that XPACK compresses
  109.             the file(s) successfully.)
  110.  
  111.         -g  This tells XPACK to merge an overlay into packed file.
  112.  
  113.              (See note below concerning files that cannot be packed.)
  114.  
  115.                Without the -g option, XPACK does not try to compress
  116.                an .EXE file that contains overlays.
  117.  
  118.              The -g option may not work with every .EXE that contains
  119.              an overlay. It works well with .EXE files compiled from
  120.              text (ASCII) with TURBOTXT (an excellent program that is
  121.              supplied with the registered version of the TURBOBAT
  122.              batch file compiler), overlay programs compiled by
  123.              TURBO/BORLAND Pascal and Clipper 5.2 with Blink 3.0
  124.  
  125.        -pd  Pack files as Data
  126.             those data files can be used by XPACK OnLine Decompression System
  127.             which gives painless access to XPACKed-Data files
  128.  
  129.         -ud  Unpack XPACKed-Data files
  130.  
  131.         -z   install (stay resident) Xpack OnLine DeCompression System
  132.  
  133.         -zr  release (uninstall TSR) Xpack OnLine DeCompression System
  134.  
  135.         -z-  deactivate (TSR off)    Xpack OnLine DeCompression System
  136.  
  137.         -z+  activate (turn TSR on)  Xpack OnLine DeCompression System
  138.  
  139.        -ux  Ultra eXpander for some high level language compiled progys! :D
  140.             (to unpack a overlay-exe, plz remember use fullpath & extension)
  141.             (this option doesn't accept wildcards! :D)
  142.  
  143.    USING XPACK to create compressed diskette image.
  144.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  145.      Enter the command:   XPACK option drive: filename
  146.  
  147.       where "filename" is the name of the compressed diskette image file.
  148.       If you do not type a file extension, ".XDI" is assumed.
  149.       The filename can include drive and path specifications.
  150.  
  151.      Here are the details of the new options:
  152.  
  153.         -p  Pack the diskette in drive: to filename
  154.  
  155.         -u  Unpack to the diskette in drive: from filename
  156.             the filename here can include wildcards (* or ?).
  157.  
  158.      EXAMPLES.
  159.      ~~~~~~~~~
  160.        To compress all the .EXE files in the current directory
  161.        just type:
  162.                           XPACK *.EXE
  163.  
  164.        To compress without backup all .EXE files in C:\PROGS,
  165.        type:
  166.                           XPACK /O C:\PROGS\*.EXE
  167.  
  168.        To pack all the Executable files using method 4, enter this
  169.        command:
  170.                           XPACK /4 *
  171.  
  172.        To compress BUMF.EXE (made from BUMF.TXT using TURBOTXT),
  173.        enter the command:
  174.                           XPACK -g BUMF
  175.  
  176.       To create a compressed diskette image named MYDISK.XDI from drive B:
  177.       type:
  178.                           XPACK -p b: MYDISK.XDI
  179.  
  180.       To unpack (restore) a compressed diskette image C:\BOOT.XDI to drive A:
  181.       type:
  182.                           XPACK -u a: C:\BOOT
  183.  
  184.        To pack all the files as data in D:\MYDATA
  185.        type:
  186.                           XPACK -Pd d:\mydata\*
  187.  
  188.        To unpack all the XPACKed-Data files in E:\MYfile
  189.        type:
  190.                           XPACK -Ud e:\myfile\*.*
  191.  
  192.        To install (stay resident) Xpack OnLine DeCompression System
  193.        type:
  194.                           XPACK -z
  195.  
  196.        To release Xpack OnLine DeCompression System
  197.        type:
  198.                           XPACK -zr
  199.  
  200.        To deactivate Xpack OnLine DeCompression System
  201.        type:
  202.                           XPACK -z-
  203.  
  204.        To active Xpack OnLine DeCompression System
  205.        type:
  206.                           XPACK -z+
  207.  
  208.      FILES THAT CAN'T BE PACKED.
  209.  
  210.        Some files can't be compressed with XPACK.
  211.  
  212.                - Programs that check the CRC of a file
  213.                - Files that store configuration data internally
  214.                - Drivers that can be loaded in a
  215.                    config.sys file (EMM386.EXE)
  216.                - Some files with "overlays" or DOS4GW overlays, etc..
  217.                    Some "overlaid" files can't be compressed because
  218.                    when you compress such a file the overlay offset
  219.                    changes and the compressed program may not find
  220.                    an overlay.
  221.  
  222.      WINDOWS AND OS/2 FILES.
  223.  
  224.       XPACK currently cannot Pack Windows or OS/2 New .EXEs are
  225.       because at the ends of these files there are resources,
  226.       which have to be located there. (e.g. the BITMAPs, Dialog, Boxes,
  227.       Buttons, and Icons)
  228.  
  229.          These resources are loaded not with the execution
  230.        of the file, but only when needed by Windows or OS/2.
  231.  
  232.          Windows and OS/2 files are automatically recognized by
  233.        XPACK.
  234.  
  235.        i'm trying to add functions to compress:
  236.        Windows 3.1, Windows 95, OS/2, DOS protect mode, DOS overlay
  237.        executables in near future! (plz .. wait:D)
  238.  
  239.      DISTRIBUTING XPACK.
  240.  
  241.        The XPACK utility is protected by copyright, and may be
  242.        distributed only according to the following limitations:
  243.          1) NO price may be charged, other than a fee for copying
  244.             and mailing the disk.
  245.          2) The utility and documentation must be included together,
  246.             in unmodified form. The XPACK.COM, XPACK.DOC and XPACK.BG5
  247.             files must stay together.
  248.  
  249.        XPACK can be freely uploaded to any BBS, online system or
  250.        something similar, and can be freely included on any CD-ROM.
  251.  
  252.        You can only distribute compressed executables or DiskImages
  253.        if you register XPACK.
  254.  
  255.      Verify Authentication
  256.      ~~~~~~~~~~~~~~~~~~~~~
  257.       To verify authentication, you can use pgp to check the signatures,
  258.       the correct messages should read:
  259.  
  260.        ...
  261.       Good signature from user "JauMing Tseng <s8203143@simon.pu.edu.tw>".
  262.       Signature made 1996/??/?? ..... GMT using 2048-bit key, key ID EE317325
  263.        ...
  264.  
  265.       To get author's public key, send a email to s8203143@simon.pu.edu.tw
  266.       with Subject: get public key
  267.        Thanks:)
  268.  
  269.  
  270.      CREDITS & Greetings
  271.  
  272.        Optimized by http://www.xs4all.nl/~feldmann
  273.        Revised documentation (XPACK.DOC) by John Kiernan, Harald Feldmann.
  274.        Translated dox (XPACK.DEU) by Veit Kannegieser, Karl Loncarek.
  275.        I thank the following people for testing and suggestions:
  276.        Fred Lu, John Kiernan, ChengChang Liu,
  277.        Harald Feldmann(Author Hamarsoft HAP archiver), Jeff Gilchrist,
  278.        Henrik Haftmann, Michal Weis, Peter Hubinsky (Slovak Antivirus Center),
  279.        Cristi Bradiceanu (The DOP), Tomas Hajny, Roeland Louwe Kooijmans,
  280.        Keith Petersen (General Manager of Simtel), Peter Gutmann, Frank Zago,
  281.        Adam Nikic, Timo Salmi, Mika Koykka, Henry Juhani Aro, Ron van Daal,
  282.        Roberto Favaretti, Bulent Eren, Michael E. Webb, Stefan Raaijmakers,
  283.        uNDeRWoRLD^TPiNC/CNF, Veit Kannegieser(Author DiskEMU),
  284.        Marcel Blanchet, Synopsis. Thank you!
  285.  
  286.         HOW DOES XPACK WORK?
  287.  
  288.           The XPACK utility works by compressing an
  289.           executable file.  The encoded program is written back to
  290.           disk under the original file name, with a relocating
  291.           decoder attached to the file.
  292.  
  293.            When the executable file executes, control passes to the
  294.          relocating decoder, which relocates itself (and the
  295.          encoded data) higher in memory. It then decodes the
  296.          program into the same place it would have been loaded if
  297.          it were not encoded. The XPACKed program resets the registers
  298.          and flags to their original forms and starts the program
  299.          just as if there had never been any encoding.
  300.  
  301.            If a "CRC" check failure occurs during decoding .EXE, it will
  302.          display a message:
  303.  
  304.             "This program is damaged and can't run!"
  305.  
  306.           and return the user to DOS.
  307.  
  308.            XPACK has a security function that prevents the .EXE program
  309.          from running if it has been tampered with or accidentally
  310.          corrupted.  You can be pretty certain that your program will
  311.          come up with all the proper screens without hanging
  312.          due to unwanted modification. Your program's underlying
  313.          data will not be left in the open (to any one with a hex editor
  314.          or disassembler) and your code will be safer from others'eyes.
  315.  
  316.         HOW DOES XPACK OnLine DeCompression System WORK?
  317.  
  318.        Once loaded, XPACK OnLine DeCompression System gives automatic
  319.        access on demand to compressed data files. It does this by
  320.        intercepting any calls a program (including COMMAND.COM) makes to DOS.
  321.        Normally, XPACK OnLine DeCompression System passes these calls
  322.        straight on to DOS, but when a call is detected which opens a
  323.        compressed data file, XPACK OnLine DeCompression System reads the
  324.        data file and makes a full size copy on disk for the program to use.
  325.        It then changes the name of the compressed data file to a name it
  326.        recognizes itself and renames the new full size file to the original
  327.        file name. Only then does it pass the call on to DOS. Neither DOS nor
  328.        the program know that this is happening, so operation is completely
  329.        automatic. When an expanded data file is closed without being modified,
  330.        XPACK OnLine DeCompression System deletes the expanded copy and renames
  331.        the original compressed data file to its original name. If a program
  332.        modifies an expanded copy of a data file, XPACK OnLine DeCompression
  333.        System deletes the compressed original and leaves the expanded new
  334.        data file on disk.
  335.  
  336.         A Special Case to XPACK OnLine DeCompression System? :)
  337.  
  338.        XPACK OnLine DeCompression System gives programs the illusion that
  339.        small data files are big data files. It does this very successfully
  340.        and almost all of the software is fooled all of the time.
  341.  
  342.        A special case is where a program obtains the size of a file from
  343.        its directory entry and then reads that number of bytes when it
  344.        opens the file. The intention is to read the whole file.
  345.  
  346.        This behavior has been seen with the DOS XCOPY command ( DOS Ver
  347.        6.22 at least) and PKZIP (Ver 1.01, 2.04g at least ) from PKWARE.
  348.  
  349.         XPACK OnLine DeCompression System still works well with those
  350.         applications! :)
  351.  
  352.      HELP and SUGGESTED IMPROVEMENTS.
  353.  
  354.          Send them to the author:
  355.  
  356.           Internet e-mail: s8203143@simon.pu.edu.tw
  357.  
  358.      URL:
  359.  
  360.        http://140.128.9.3/home1/86Ga/s8203143/public_html/xpack.html
  361.           (Dep. of Computer Science and Info. Mgt, Providence Univ.)
  362.  
  363.        The latest version of XPACK can always be found on:
  364.  
  365.           Slovak Antivirus Center: ftp.elf.stuba.sk /pub/pc/pack
  366.           Walnut Creek CDROM: ftp.simtel.net /pub/simtelnet/msdos/execomp
  367.           Garbo archives: garbo.uwasa.fi /pc/execomp
  368.  
  369.            Some mirrors of Slovak Antivirus Center:
  370.  
  371.           ftp.vse.cz           /pub/msdos/SAC/pc/pack (Czech)
  372.           ftp-beer.bke.hu      /vol1/pub/sac/pc/pack (Hungary)
  373.           ftp.cs.tu-berlin.de  /pub/msdos/mirrors/stuba/pc/pack (Germany)
  374.  
  375.      DISCLAIMER.
  376.  
  377.        Under no circumstances can I, or anyone else who assisted in
  378.     writing XPACK or any of the accompanying files, be held responsible
  379.     for any damage resulting out of the use or inability to use any of
  380.     the files or programs in this Xpack release archive.
  381.  
  382.      All programs mentioned in this documentation are trademarks of their
  383.      respective owners. They are used for identification purposes only.
  384.  
  385.      Registration
  386.      ~~~~~~~~~~~~
  387.         XPACK(1.60+) is NOT a free program. It is being released
  388.         as shareware. This means that you are allowed to try out
  389.         XPACK and its various features for a limited  amount  of
  390.         time,  in which you may evaluate the suitability of this
  391.         software to your use.
  392.  
  393.         XPACK  has  not  been  disabled  in  any  way   in   the
  394.         shareware version. One is granted a  30  day  period  in
  395.         which  to  evaluate  the  suitability  of XPACK to one's
  396.         needs.  If you use  XPACK  for a period longer than this
  397.         evaluation period, it is assumed that XPACK is of use to
  398.         you, and that you will register it.
  399.  
  400.           The registration fee for Xpack 1.60+ has been set to
  401.           USD 20,- for an e-mailed diskimage bonus pack.
  402.           USD 30,- for an air-mailed diskette bonus pack.
  403.  
  404.           Add USD 15,- for cheques and bank transfers in Europe.
  405.  
  406.         European users please see xpack.frm for details :)
  407.  
  408.         Other foreign users please read the following:
  409.         ---
  410.         This program(v161) can be registered via the Internet at
  411.         Albert's Ambry.
  412.  
  413.         Please go to:
  414.                         http://www.alberts.com
  415.  
  416.         Search on: >> xpack161.zip <<
  417.  
  418.         Click on the "Buy It" Hotlink to register this software.
  419.  
  420.         Thank you for registering this program. :)
  421.         ----
  422.           Registered users will receive a bonus pack which contains
  423.         utilities. (uuencoded if you have e-mail)
  424.  
  425.         Have you decided to register?  That's very kind of  you.
  426.         Thanks!   The  more   registrations  i  get   the   more
  427.         improvements i will make to this program.
  428.  
  429.   End of the XPACK documentation file.
  430.  
  431.