home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1995 November / PCWK1195.iso / inne / dos / programo / pmw120.exe / UTILS.DOC < prev   
Encoding:
Text File  |  1995-07-28  |  10.2 KB  |  231 lines

  1. ------------------------------------------------------------------------------
  2. --------------------------- Utilities for PMODE/W ----------------------------
  3. ------------------------------------------------------------------------------
  4.  
  5.   This is the documentation for the PMODE/W v1.20 utilities PMWSETUP, PMWBIND,
  6. and PMWLITE. These utilities are Copyright (c) 1995, Charles Scheffold and
  7. Thomas Pytel. All rights reserved.
  8.  
  9. Contents:
  10. ---------
  11.  
  12. 1 - PMWSETUP
  13.     1.0 - Description
  14.     1.1 - PMODE/W Parameters
  15.     1.2 - Editing
  16.  
  17. 2 - PMWBIND
  18.     2.0 - Description
  19.     2.1 - Commands
  20.     2.2 - Switches
  21.  
  22. 3 - PMWLITE
  23.     3.0 - Description
  24.     3.1 - Switches
  25.  
  26. ------------------------------------------------------------------------------
  27. ---------------------------------- PMWSETUP ----------------------------------
  28. ------------------------------------------------------------------------------
  29.  
  30. 1.0 - Description:
  31. ------------------
  32.  
  33.   PMWSETUP is a program which will allow you to modify the various PMODE/W
  34. parameters which affect the way it executes. You may modify these parameters
  35. within any program which uses PMODE/W. Or you may edit them within the PMODE/W
  36. extender itself, where they will be passed on to any program compiled with
  37. that modified version of PMODE/W. The syntax for PMWSETUP is as follows:
  38.  
  39.   PMWSETUP <filename>
  40.  
  41. where <filename> is the path name of the executable you wish to modify or
  42. "PMODEW.EXE" itself.
  43.  
  44. 1.1 - PMODE/W Parameters:
  45. -------------------------
  46.  
  47.   For a more detailed explanation of these parameters, see the PMODE/W
  48. documentation. Minimums and maximums will be enforced by the PMWSETUP program
  49. for the settings, but you must still make sure that the values you set are
  50. appropriate for your program. The parameters are as follows:
  51.  
  52. ) Number of VCPI Page Tables:
  53.  
  54.     This parameter specifies the maximum number of page tables allowed under a
  55.   VCPI server. For each page table used at run time, 4k of low memory is used
  56.   by PMODE/W.
  57.  
  58. ) VCPI/XMS/raw Max Selectors:
  59.  
  60.     This parameter specifies the number of selectors that PMODE/W will make
  61.   available when a DPMI host is not in place. PMODE/W needs only 8 bytes of
  62.   low memory for each selector, so you may set high values for this parameter.
  63.  
  64. ) Real Mode Stack Length:
  65.  
  66.     This parameter specifies the length of the real mode stack provided by
  67.   PMODE/W to real mode interrupt or IRQ calls. The size is in paragraphs.
  68.   PMODE/W allocates low memory for real mode stacks when it initializes, and
  69.   that memory can not be used for anything else.
  70.  
  71. ) Protected Mode Stack Length:
  72.  
  73.     This parameter specifies the length of the protected mode stack provided
  74.   by PMODE/W to real mode callbacks to protected mode or protected mode IRQ
  75.   handlers issued during real mode processing. The size is in paragraphs.
  76.   PMODE/W allocates low memory for protected mode stacks when it initializes,
  77.   and that memory can not be used for anything else.
  78.  
  79. ) Real Mode Stack Nesting:
  80.  
  81.     This parameter specifies the maximum number of nested real mode stacks
  82.   that PMODE/W will provide. PMODE/W will allocate this number of real mode
  83.   stacks when it initializes. So for example, 8 stacks at 40h paragraphs each
  84.   will allocate a total of 8k for real mode stacks.
  85.  
  86. ) Protected Mode Stack Nesting:
  87.  
  88.     This parameter specifies the maximum number of nested protected mode
  89.   stacks that PMODE/W will provide. PMODE/W will allocate this number of
  90.   protected mode stacks when it initializes. So for example, 8 stacks at 80h
  91.   paragraphs each will allocate a total of 16k for protected mode stacks.
  92.  
  93. ) Number of Real Mode Callbacks:
  94.  
  95.     This parameter specifies the maximum number of DPMI real mode callbacks
  96.   that PMODE/W will provide when a DPMI host is not in place. PMODE/W needs
  97.   25 bytes of low memory per callback, which is allocated during
  98.   initialization.
  99.  
  100. ) VCPI/DPMI Detection Mode:
  101.  
  102.     This parameter specifies the order of detection for VCPI and DPMI. This
  103.   allows for detection and use of VCPI for speed under a system that supports
  104.   both DPMI and VCPI.
  105.  
  106. ) Maximum Extended Memory to Allocate:
  107.  
  108.     This parameter specifies the maximum amount of extended memory for PMODE/W
  109.   to allocate from the system. The size is in bytes. Specifying a lower value
  110.   for this parameter than there is extended memory in the system will force
  111.   PMODE/W to leave some extended memory free for use by other extenders and
  112.   programs that use XMS and EMS. Your program will not necessarily have this
  113.   much extended memory available to it due to other PMODE/W and Watcom C/C++
  114.   system requirements for extended memory.
  115.  
  116. ) Low Memory to Reserve:
  117.  
  118.     This parameter specifies the minimum amount of low memory for PMODE/W to
  119.   reserve for the program. PMODE/W will try to preserve this low memory by
  120.   loading 32 bit code and data into extended memory if it can, but the memory
  121.   is not guaranteed to be available. Setting this parameter to a very high
  122.   value ensures PMODE/W will leave as much low memory free as possible.
  123.  
  124. ) Maximum Physical Address Mapping Page Tables:
  125.  
  126.     This parameter specifies the maximum number of page tables to be made
  127.   available by PMODE/W under VCPI for physical address mapping. PMODE/W needs
  128.   4k of extended memory for each page table for address mapping.
  129.  
  130. 1.2 - Editing:
  131. --------------
  132.  
  133.   While in PMWSETUP, the arrow keys move the selection bar, SPACE toggles
  134. hex/decimal display, and ENTER allows you to enter a new value for the
  135. currently selected parameter. PMWSETUP will not allow you to exceed the
  136. minimum or maximum values for the parameters, but common sense must also be
  137. used when assigning very low or high settings. When you are done modifying the
  138. parameters, you may save your changes. If you decide not to make any changes,
  139. you may abort, and any parameters you have modified will not be written to the
  140. file you are editing.
  141.  
  142. ------------------------------------------------------------------------------
  143. ---------------------------------- PMWBIND -----------------------------------
  144. ------------------------------------------------------------------------------
  145.  
  146. 2.0 - Description:
  147. ------------------
  148.  
  149.   PMWBIND is a program which binds and unbinds stub programs to and from
  150. protected mode LE executable files (the file format used by DOS/4GW, and
  151. PMODE/W). This allows you to replace older versions of PMODE/W within an
  152. executable file with newer ones. It also allows you to turn a DOS/4GW,
  153. DOS/4GW PRO, or DOS/4G PRO program into a PMODE/W program very easily just by
  154. replacing the stub. This practice in not really suggested though since you do
  155. not know if the program in question uses any DOS/4G specific functions which
  156. will not work with PMODE/W. But in general, many programs are completely
  157. portable from DOS/4GW to PMODE/W with little or no tweaking of the PMODE/W
  158. parameters. PMWBIND will not allow you to bind or unbind a compressed
  159. protected mode PMODE/W executable due to the fact that it is not an ordinary
  160. LE executable and it would really serve no point. The syntax for PMWBIND is
  161. as follows:
  162.  
  163.   PMWBIND <command> [options] <filename>
  164.  
  165. where <command> is the operation you want to perform (bind, unbind, or
  166. replace), [options] are various options, and <filename> is the path name of
  167. the program you wish to modify.
  168.  
  169. 2.1 - Commands:
  170. ---------------
  171.  
  172. ) /B - Bind PMODE/W (or specified stub) to an unbound LE executable file.
  173. ) /U - Unbind the stub from a DOS/4GW, DOS/4GW PRO, DOS/4G PRO or PMODE/W
  174.        executable file.
  175. ) /R - Replace the stub of a DOS/4GW, DOS/4GW PRO, DOS/4G PRO or PMODE/W
  176.        executable file.
  177.  
  178. 2.2 - Switches:
  179. ---------------
  180.  
  181. ) /D<filename> - Use <filename> for destination of bound or unbound executable
  182.                  instead of default.
  183. ) /N           - Suppress output of executable file (used only with /U
  184.                  command).
  185. ) /O           - Overwrite destination files if they exist.
  186. ) /S<filename> - Specify a stub to use instead of searching for "PMODEW.EXE".
  187.                  If you do not specify this switch, the current directory will
  188.                  be checked for "PMODEW.EXE", then the Watcom "\BINB"
  189.                  directory, then the "\BIN" directory, and finally the Watcom
  190.                  main directory itself.
  191. ) /W<filename> - Write the unbound stub to <filename> instead of discarding.
  192.  
  193. ------------------------------------------------------------------------------
  194. ---------------------------------- PMWLITE -----------------------------------
  195. ------------------------------------------------------------------------------
  196.  
  197. 3.0 - Description:
  198. ------------------
  199.  
  200.   PMWLITE is a program which compresses protected mode LE executables for use
  201. with PMODE/W. It does basically what real mode EXE compression programs do
  202. for real mode programs. PMWLITE will accept DOS/4GW, DOS/4GW PRO, DOS/4G PRO,
  203. and uncompressed PMODE/W programs and compress them for use with the current
  204. version of PMODE/W. If you are compressing a program with a different version
  205. of PMODE/W in it, the current version will be put in. When the compressed
  206. protected mode program is run, PMODE/W will decompress it as it is loading in
  207. into memory. The syntax for PMWLITE is as follows:
  208.  
  209.   PMWLITE [options] <filename>
  210.  
  211. where [options] are various options, and <filename> is the path name of the
  212. program you wish to compress.
  213.  
  214. 3.1 - Switches:
  215. ---------------
  216.  
  217. ) /Cx          - Compression level to use, where x is 4 for Max, 3 for Extra,
  218.                  2 for Normal, 1 for Faster, and 0 for Fastest compression.
  219. ) /D<filename> - Use <filename> for destination of compressed executable
  220.                  instead of default (which is the input filename).
  221. ) /S<filename> - Specify a stub to use instead of searching for "PMODEW.EXE".
  222.                  If you do not specify this switch, the current directory will
  223.                  be checked for "PMODEW.EXE", then the Watcom "\BINB"
  224.                  directory, then the "\BIN" directory, and finally the Watcom
  225.                  main directory itself.
  226.  
  227. ------------------------------------------------------------------------------
  228. ----------------------- End of Utilities Documentation -----------------------
  229. ------------------------------------------------------------------------------
  230.  
  231.