home *** CD-ROM | disk | FTP | other *** search
/ Software Recommendations - 1998 Season 1 / DNBCD4.iso / share / compress / exe / exe2com / EXE2COM.DOC < prev    next >
Encoding:
Text File  |  1995-02-20  |  10.9 KB  |  289 lines
  1.                                    - 1 -
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                  File conversion utility - EXE2COM v.2.00
  17.           Copyright (C) 1991-1995 PSP Soft. All Rights Reserved.
  18.                              By Paul Shpilsher
  19.                               CIS: 71303,1465
  20.                     INTERNET: 71303.1465@compuserve.com
  21.  
  22.                                   Index:
  23.  
  24.                    Copyright..........................2
  25.                    Freeware...........................2
  26.                    Distribution policy................2
  27.                    Legal Status, warranty.............2
  28.                    Other Comments.....................3
  29.                    EXE2COM............................3
  30.                    Limitations........................4
  31.                    Virus protection...................4
  32.                    Error Messages.....................4
  33.                    Misc...............................5
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                                          - 2 -
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65. COPYRIGHT:
  66.      This program IS Copyright (C) 1991-1995 by:  Paul Shpilsher  (PSP
  67.      Soft)  Contact  me  if  you  have  reason to believe this utility
  68.      package has been subject to any malevolent tampering,  or if  you
  69.      wish to receive a current,  complete, unmodified and "guaranteed"
  70.      virus-free copy.
  71.  
  72.      Although this utility package may be archived  along  with  other
  73.      software, including my own, the following pertains solely to THIS
  74.      portion of it.
  75.  
  76.  
  77. FREEWARE:
  78.      This program is FREEWARE.  You may use,  copy free of charge, but
  79.      you may not change any of the files in the package.
  80.  
  81.      * NEVER change copyright statements:  the copyright remains in my
  82.      hands.  I  will  not be as generous in providing FREE software in
  83.      the future if I find that  anyone  has  violated  this  (or  any)
  84.      requirement!
  85.  
  86.      * Program may not be sold or hired.
  87.  
  88. DISTRIBUTION POLICY:
  89.      You can distribute  this  utility  package  under  the  following
  90.      conditions:
  91.  
  92.      * You  ask  no  contribution  from  the  receiver of this utility
  93.      package except for a nominal copying charge not to exceed US  $10
  94.      (ten US dollars).  (CD-ROM,  tape,  and similar large *shareware*
  95.      collections are limited to a "reasonable",  which may  exceed  US
  96.      $10.)
  97.  
  98.      * ALL original files are distributed together.
  99.  
  100.      NOTE: Other  than according to the above provisions,  the SALE of
  101.      this program or its parts for PROFIT,  either alone  or  together
  102.      with  other software or hardware,  requires a licensing agreement
  103.      possibly providing for royalty payments.  Please write for terms.
  104.      (This  program [the *entire* package] may be bundled,  without my
  105.      knowledge, with other FREE software.)
  106.  
  107.  
  108.  
  109. LEGAL STATUS, WARRANTY:
  110.      Since this program is licensed free of charge,  the author,  Paul
  111.  
  112.                                          - 3 -
  113.      Shpilsher,  provides absolutely no warranty of any  kind,  either
  114.      expressed or implied,  including, but not limited to, the implied
  115.      warranties of fitness for a particular purpose.
  116.  
  117.      This program is provided "as is";  the  entire  risk  as  to  the
  118.      quality  and  performance of the program is with you.  Should the
  119.      program prove defective,  you assume the cost  of  all  necessary
  120.      servicing, repair or correction.
  121.  
  122.      In no event will any copyright holder, or any other party who may
  123.      modify and/or redistribute the program  as  permitted  below,  be
  124.      liable  to  you  for  damages,  including  any general,  special,
  125.      incidental or consequential damages arising out  of  the  use  or
  126.      inability  to  use the program (including but not limited to loss
  127.      of data or data being rendered inaccurate or losses sustained  by
  128.      you  or third parties or a failure of the program to operate with
  129.      any other programs),  even if such holder or other party has been
  130.      advised of the possibility of such damages.
  131.  
  132. OTHER COMMENTS:
  133.      Although use  of  this program is FREE,  donations are welcome to
  134.      offset the costs of Borland TC++ and  the  distribution  of  this
  135.      product.  Half  of  all  revenues and ALL profits will be sent to
  136.      Compassion  International,   an   organization   which   arranges
  137.      long-term  sponsorships  in  order  to  provide  for  the mental,
  138.      physical and spiritual needs of impoverished children  worldwide.
  139.      [Other  non-profit  organizations  may  be  substituted  at  your
  140.      request.]
  141.  
  142.  
  143. EXE2COM:
  144.      EXE2COM is a file utility similar to DOS's <<exe2bin>>.  In other
  145.      words this utility converts executable files (ext.EXE) to command
  146.      files (ext.COM).  The format of EXE-files are more complex  than
  147.      format of COM-files.  A COM-format file is a binary image of the
  148.      code and data of the program. The file must be less than 64K, and
  149.      no segment-address  relocation  takes  place.  A  EXE-format file
  150.      containes a special header  that  directs  loader  in  performing
  151.      adjustments to  segment  references  in  a load module.  In other
  152.      words, EXE-file can have multiple segments of the code,  data and
  153.      stack; and  it  does  not have restrictions on file size.  Sounds
  154.      complicated?! If you don't have a clue what I  am  talking  about
  155.      don't warry.  The  main  idea is:  COM-format files are much more
  156.      simpler than EXE-format ones. Enough of the theory! So, DOS has a
  157.      utility <<exe2bin>>  to  convert  EXE-format files to COM-format.
  158.      You might ask why bother to make another one.  Well,  <<exe2bin>>
  159.      have some limitations:  EXE-file has to have only one segment (no
  160.      relocation table) and the entry point should be at PSP:100h. As I
  161.      noticed that  the  most  of the EXE-files don't go by these rules
  162.      (they have relocation table and the entry point is different than
  163.      PSP:100h). In these cases <<exe2bin>> will not work.  So,  I made
  164.      up an utility <<EXE2COM>> that goes over these limitations.
  165.  
  166.  
  167.  
  168.                                          - 4 -
  169.      Usage: EXE2COM file.exe [file.com] [/I]
  170.      where:        file.exe   -> EXE-format source file
  171.                    file.com   -> COM-format target file
  172.                    /I         -> misc info ( how to reach me )
  173.  
  174.      Examples:
  175.                    To convert file PROG.EXE to PROG.COM:
  176.                        EXE2COM PROG.EXE PROG.COM
  177.                                   or
  178.                        EXE2COM PROG.EXE
  179.  
  180.                    To convert file PROG1.EXE to PROG2.COM:
  181.                        EXE2COM PROG1.EXE PROG2.COM
  182.  
  183.  
  184.                    NOTE: you do not have to specify the 2nd  parameter
  185.                    if you  want  to get COM-file with the same name as
  186.                    the EXE-file. (see example 1)
  187.  
  188.      As a result of this program you'll get a COM-format file with the
  189.      name you  specified  or  with  the  default name.  If all went Ok
  190.      you'll get the message:  PROG1.EXE  =>  PROG2.COM , otherwise  see
  191.      ERROR MESSAGES.  The  target  files (COM-format) usualy have less
  192.      size than their EXE-file originals.
  193.  
  194. LIMITATIONS:
  195.      The source  file should be less than 64K;  source file should not
  196.      have an overlay (the image size is equal the load size)!
  197.  
  198. VIRUS PROTECTION:
  199.      File EXE2COM.COM is protected with anti-virus driver VACCINE.  It
  200.      will  keep  most  viruses  away  from this file.  If your copy of
  201.      EXE2COM is "sick" by a virus,  the program  will  tell  you  that
  202.      immediately.  Also  you  will  have  an option to remove a virus.
  203.      Prompt:  File Damaged!!! [A]bort, [R]ewrite, [C]ontinue. Pressing
  204.      key  [A]  will  terminate  program;  [R]  will attempt to restore
  205.      original file and  continue  with  a  program;  [C]  will  resume
  206.      program.  You can be false alarmed if you try to hack or compress
  207.      EXE2COM.COM with PKLITE or similar  programs.  To  prevent  false
  208.      alarms just leave EXE2COM.COM the way it is.
  209.  
  210. ERROR MESSAGES:
  211.                    
  212.      << Usage: EXE2COM file.exe [file.com] [/I] >>
  213.          Cause and possible treatment:
  214.                    Your command arguments are wrong or absent.
  215.                    Review command line.
  216.  
  217.      << Can not read from disk >>
  218.                 &
  219.      << Internal (LSEEK) >>
  220.          Cause and possible treatment:
  221.                    Error in reading the source file.  Check if the
  222.                    disk is Ok  (FAT, physical damage).
  223.  
  224.                                          - 5 -
  225.  
  226.      << Can not open file >>
  227.          Cause and possible treatment:
  228.                    The source file is  present,  but  the  program  is
  229.                    unable to open it.  Increase the number of Files=xx
  230.                    in the CONFIG.SYS.  Or check network  drive  access
  231.                    priveleges.
  232.  
  233.      << Can not create file >>
  234.          Cause and possible treatment:
  235.                    The source file might be  a  reserved  device,  the
  236.                    disk is write protected or has no free space. Check
  237.                    network drive access priveleges.
  238.  
  239.      << Can not write to disk >>
  240.          Cause and possible treatment:
  241.                    Check free space on the disk.  Check network  drive
  242.                    access priveleges.
  243.  
  244.      << File has to be smaller than 64K >>
  245.          Cause and possible treatment:
  246.                    Your source  file  is  too big.  Try to compress it
  247.                    (PKLITE).
  248.  
  249.      << Wrong type of file (not .EXE) >>
  250.          Cause and possible treatment:
  251.                    Your source file is not an EXE-format file.
  252.  
  253.      << File size mismatch (overlay) >>
  254.          Cause and possible treatment:
  255.                    The image size of the source file is different than
  256.                    the load size of it. (Possible overlay).
  257.  
  258.      << Not enough memory >>
  259.          Cause and possible treatment:
  260.                    The utility needs more memory. Try to increase free
  261.                    RAM (remove TRS-type programs from RAM)
  262.  
  263. MISC:
  264.      ANYONE who finds a bug is encouraged to notify me.  I will try to
  265.      fix it. I will also try to respond to requests for alterations or
  266.      enhancements, including customization.
  267.  
  268.      I am willing to take  on  new  programming  projects.  I  welcome
  269.      challenges,  but I am realistic about my abilities.  Therefore, I
  270.      will take suggestions, but I ask that you realize my limitations.
  271.  
  272.      If I choose to write a program for you, I can almost guarantee we
  273.      can  arrange some form of acceptable compensation for my efforts.
  274.      I may ask nothing!
  275.  
  276.      I can be contacted  on  CompuServe  71303,1465  or  on  INTERNET:
  277.      71303.1465@compuserve.com
  278.  
  279.  
  280.                                          - 6 -
  281.      IF YOU CONTACT ME, tell me HOW, WHEN, and WHERE you obtained this
  282.      program.
  283.                    
  284.                    
  285.                    
  286.                    
  287.     
  288.                    
  289.