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