home *** CD-ROM | disk | FTP | other *** search
/ Computer Installation Guide - Dragon Clan Series / CD2.iso / DOSTOOLS / PMODEW / UTILS.DOC < prev   
Encoding:
Text File  |  1996-12-31  |  13.2 KB  |  294 lines
  1. ------------------------------------------------------------------------------
  2. --------------------------- Utilities for PMODE/W ----------------------------
  3. ------------------------------------------------------------------------------
  4.  
  5.   This is the documentation for the PMODE/W v1.33 utilities PMWSETUP, PMWBIND,
  6. PMWLITE, and PMWVER. These utilities are Copyright (c) 1995-1997, Charles
  7. Scheffold and Thomas Pytel. All rights reserved.
  8.  
  9. Contents:
  10. ---------
  11.  
  12. 1 - PMWSETUP
  13.     1.0 - Description
  14.     1.1 - Interactive Mode
  15.     1.2 - Command Line Mode
  16.     1.3 - PMODE/W Parameters
  17.  
  18. 2 - PMWBIND
  19.     2.0 - Description
  20.     2.1 - Commands
  21.     2.2 - Switches
  22.  
  23. 3 - PMWLITE
  24.     3.0 - Description
  25.     3.1 - Switches
  26.  
  27. 4 - PMWVER
  28.     4.0 - Description
  29.  
  30. ------------------------------------------------------------------------------
  31. ---------------------------------- PMWSETUP ----------------------------------
  32. ------------------------------------------------------------------------------
  33.  
  34. 1.0 - Description:
  35. ------------------
  36.  
  37.   PMWSETUP is a program which will allow you to modify the various PMODE/W
  38. parameters which affect the way it executes. You may modify these parameters
  39. within any program which uses PMODE/W. Or you may edit them within the PMODE/W
  40. extender itself, where they will be passed on to any program compiled with
  41. that modified version of PMODE/W. PMWSETUP can run in one of two different
  42. modes: interactive or command line. In interactive mode, configuration is
  43. performed via an on-screen menu. If command line options are specified, the
  44. menu will not be shown and configuration data will be taken from the command
  45. line. The syntax for PMWSETUP is as follows:
  46.  
  47.   PMWSETUP [commands] [options] <filename>
  48.  
  49. where [commands] are the configuration directives, [options] are various
  50. options that affect PMWSETUP, and <filename> is the path name of the
  51. executable you wish to modify or "PMODEW.EXE" itself.
  52.  
  53. 1.1 - Interactive Mode:
  54. -----------------------
  55.  
  56.   While in PMWSETUP, the arrow keys move the selection bar, SPACE toggles
  57. hex/decimal display, and ENTER allows you to enter a new value for the
  58. currently selected parameter. PMWSETUP will not allow you to exceed the
  59. minimum or maximum values for the parameters, but common sense must also be
  60. used when assigning very low or high settings. When you are done modifying the
  61. parameters, you may save your changes. If you decide not to make any changes,
  62. you may abort, and any parameters you have modified will not be written to the
  63. file you are editing.
  64.  
  65. 1.2 - Command Line Mode:
  66. ------------------------
  67.   When command line options are specified, PMWSETUP will not display the
  68. usual configuration screen. These options can be specified in any order. If
  69. a configuration variable exceeds its maximum or falls below its minimum, it
  70. will be automatically adjusted accordingly. The parameters are explained in
  71. detail in the next section. All values passed are expected to be in decimal,
  72. unless preceded by a "0x" to denote a hexadecimal number.
  73.  
  74. The following is a list of switches available:
  75.  
  76. ) /V<page tables> Number of VCPI page tables to allocate
  77. ) /S<selectors>   VCPI/XMS/Raw maximum selectors
  78. ) /R<stacklen>    Real mode stack length (in paragraphs)
  79. ) /P<stacklen>    Protected mode stack length (in paragraphs)
  80. ) /N<nesting>     Real mode stack nesting
  81. ) /E<nesting>     Protected mode stack nesting
  82. ) /C<callbacks>   Number of real mode callbacks
  83. ) /M<0|1>         VCPI/DPMI detection mode (0=DPMI first, 1=VCPI first)
  84. ) /X<memory>      Maximum extended memory to allocate (in bytes)
  85. ) /L<low memory>  Low memory to reserve (in paragraphs)
  86. ) /A<page tables> Number of physical address mapping page tables
  87. ) /B<0|1>         Display copyright message at startup (0=No, 1=Yes)
  88.  
  89. ) /Q              Quiet mode (no status messages during processing)
  90.  
  91. * NOTE - PMWSETUP will only modify the parameters specified on the command
  92.          line. Any options not specified will remain unchanged.
  93.  
  94. 1.3 - PMODE/W Parameters:
  95. -------------------------
  96.  
  97.   For a more detailed explanation of these parameters, see the PMODE/W
  98. documentation. Minimums and maximums will be enforced by the PMWSETUP program
  99. for the settings, but you must still make sure that the values you set are
  100. appropriate for your program. The parameters are as follows:
  101.  
  102. ) Number of VCPI Page Tables:
  103.  
  104.     This parameter specifies the maximum number of page tables allowed under a
  105.   VCPI server. For each page table used at run time, 4k of low memory is used
  106.   by PMODE/W.
  107.  
  108. ) VCPI/XMS/raw Max Selectors:
  109.  
  110.     This parameter specifies the number of selectors that PMODE/W will make
  111.   available when a DPMI host is not in place. PMODE/W needs only 8 bytes of
  112.   low memory for each selector, so you may set high values for this parameter.
  113.  
  114. ) Real Mode Stack Length:
  115.  
  116.     This parameter specifies the length of the real mode stack provided by
  117.   PMODE/W to real mode interrupt or IRQ calls. The size is in paragraphs.
  118.   PMODE/W allocates low memory for real mode stacks when it initializes, and
  119.   that memory can not be used for anything else.
  120.  
  121. ) Protected Mode Stack Length:
  122.  
  123.     This parameter specifies the length of the protected mode stack provided
  124.   by PMODE/W to real mode callbacks to protected mode or protected mode IRQ
  125.   handlers issued during real mode processing. The size is in paragraphs.
  126.   PMODE/W allocates low memory for protected mode stacks when it initializes,
  127.   and that memory can not be used for anything else.
  128.  
  129. ) Real Mode Stack Nesting:
  130.  
  131.     This parameter specifies the maximum number of nested real mode stacks
  132.   that PMODE/W will provide. PMODE/W will allocate this number of real mode
  133.   stacks when it initializes. So for example, 8 stacks at 40h paragraphs each
  134.   will allocate a total of 8k for real mode stacks.
  135.  
  136. ) Protected Mode Stack Nesting:
  137.  
  138.     This parameter specifies the maximum number of nested protected mode
  139.   stacks that PMODE/W will provide. PMODE/W will allocate this number of
  140.   protected mode stacks when it initializes. So for example, 8 stacks at 80h
  141.   paragraphs each will allocate a total of 16k for protected mode stacks.
  142.  
  143. ) Number of Real Mode Callbacks:
  144.  
  145.     This parameter specifies the maximum number of DPMI real mode callbacks
  146.   that PMODE/W will provide when a DPMI host is not in place. PMODE/W needs
  147.   25 bytes of low memory per callback, which is allocated during
  148.   initialization.
  149.  
  150. ) VCPI/DPMI Detection Mode:
  151.  
  152.     This parameter specifies the order of detection for VCPI and DPMI. This
  153.   allows for detection and use of VCPI for speed under a system that supports
  154.   both DPMI and VCPI.
  155.  
  156. ) Maximum Extended Memory to Allocate:
  157.  
  158.     This parameter specifies the maximum amount of extended memory for PMODE/W
  159.   to allocate from the system. The size is in bytes. Specifying a lower value
  160.   for this parameter than there is extended memory in the system will force
  161.   PMODE/W to leave some extended memory free for use by other extenders and
  162.   programs that use XMS and EMS. Your program will not necessarily have this
  163.   much extended memory available to it due to other PMODE/W and Watcom C/C++
  164.   system requirements for extended memory.
  165.  
  166. ) Low Memory to Reserve:
  167.  
  168.     This parameter specifies the minimum amount of low memory for PMODE/W to
  169.   reserve for the program. PMODE/W will try to preserve this low memory by
  170.   loading 32 bit code and data into extended memory if it can, but the memory
  171.   is not guaranteed to be available. Setting this parameter to a very high
  172.   value ensures PMODE/W will leave as much low memory free as possible.
  173.  
  174. ) Maximum Physical Address Mapping Page Tables:
  175.  
  176.     This parameter specifies the maximum number of page tables to be made
  177.   available by PMODE/W under VCPI for physical address mapping. PMODE/W needs
  178.   4k of extended memory for each page table for address mapping.
  179.  
  180. ) Display Copyright Message At Startup:
  181.  
  182.     This parameter is checked by PMODE/W at startup in order to decide whether
  183.   or not the copyright message is displayed during initialization.
  184.  
  185. ------------------------------------------------------------------------------
  186. ---------------------------------- PMWBIND -----------------------------------
  187. ------------------------------------------------------------------------------
  188.  
  189. 2.0 - Description:
  190. ------------------
  191.  
  192.   PMWBIND is a program which binds and unbinds stub programs to and from
  193. protected mode LE executable files (the file format used by DOS/4GW, and
  194. PMODE/W). This allows you to replace older versions of PMODE/W within an
  195. executable file with newer ones. It also allows you to turn a DOS/4GW,
  196. DOS/4GW PRO, or DOS/4G PRO program into a PMODE/W program very easily just by
  197. replacing the stub. This practice in not really suggested though since you do
  198. not know if the program in question uses any DOS/4G specific functions which
  199. will not work with PMODE/W. But in general, many programs are completely
  200. portable from DOS/4GW to PMODE/W with little or no tweaking of the PMODE/W
  201. parameters. PMWBIND will not allow you to bind or unbind a compressed
  202. protected mode PMODE/W executable due to the fact that it is not an ordinary
  203. LE executable and it would really serve no point. The syntax for PMWBIND is
  204. as follows:
  205.  
  206.   PMWBIND <command> [options] <filename>
  207.  
  208. where <command> is the operation you want to perform (bind, unbind, or
  209. replace), [options] are various options, and <filename> is the path name of
  210. the program you wish to modify.
  211.  
  212. 2.1 - Commands:
  213. ---------------
  214.  
  215. ) /B - Bind PMODE/W (or specified stub) to an unbound LE executable file.
  216. ) /U - Unbind the stub from a DOS/4GW, DOS/4GW PRO, DOS/4G PRO or PMODE/W
  217.        executable file.
  218. ) /R - Replace the stub of a DOS/4GW, DOS/4GW PRO, DOS/4G PRO or PMODE/W
  219.        executable file.
  220.  
  221. 2.2 - Switches:
  222. ---------------
  223.  
  224. ) /D<filename> - Use <filename> for destination of bound or unbound executable
  225.                  instead of default.
  226. ) /N           - Suppress output of executable file (used only with /U
  227.                  command).
  228. ) /O           - Overwrite destination files if they exist.
  229. ) /S<filename> - Specify a stub to use instead of searching for "PMODEW.EXE".
  230.                  If you do not specify this switch, the current directory will
  231.                  be checked for "PMODEW.EXE", then the Watcom "\BINB"
  232.                  directory, then the "\BIN" directory, the "\BINW" directory,
  233.                  and finally the Watcom main directory itself.
  234. ) /W<filename> - Write the unbound stub to <filename> instead of discarding.
  235.  
  236. ------------------------------------------------------------------------------
  237. ---------------------------------- PMWLITE -----------------------------------
  238. ------------------------------------------------------------------------------
  239.  
  240. 3.0 - Description:
  241. ------------------
  242.  
  243.   PMWLITE is a program which compresses protected mode LE executables for use
  244. with PMODE/W. It does basically what real mode EXE compression programs do
  245. for real mode programs. PMWLITE will accept DOS/4GW, DOS/4GW PRO, DOS/4G PRO,
  246. and uncompressed PMODE/W programs and compress them for use with the current
  247. version of PMODE/W. If you are compressing a program with a different version
  248. of PMODE/W in it, the current version will be put in. When the compressed
  249. protected mode program is run, PMODE/W will decompress it as it is loading in
  250. into memory. The syntax for PMWLITE is as follows:
  251.  
  252.   PMWLITE [options] <filename>
  253.  
  254. where [options] are various options, and <filename> is the path name of the
  255. program you wish to compress.
  256.  
  257. NOTE: PMODE/W v1.20 or later is required for your compressed program to run.
  258.       Any older version of PMODE/W will simply exit with the message "Error
  259.       Loading LE!".
  260.  
  261. 3.1 - Switches:
  262. ---------------
  263.  
  264. ) /Cx          - Compression level to use, where x is 4 for Max, 3 for Extra,
  265.                  2 for Normal, 1 for Faster, and 0 for Fastest compression.
  266. ) /D<filename> - Use <filename> for destination of compressed executable
  267.                  instead of default (which is the input filename).
  268. ) /S<filename> - Specify a stub to use instead of searching for "PMODEW.EXE".
  269.                  If you do not specify this switch, the current directory will
  270.                  be checked for "PMODEW.EXE", then the Watcom "\BINB"
  271.                  directory, then the "\BIN" directory, the "\BINW" directory,
  272.                  and finally the Watcom main directory itself.
  273.  
  274. ------------------------------------------------------------------------------
  275. ---------------------------------- PMWVER ------------------------------------
  276. ------------------------------------------------------------------------------
  277.  
  278. 4.0 - Description:
  279. ------------------
  280.  
  281.   PMWVER is a very simple utility to print out the version of PMODE/W which
  282. a program is using. It does not have any fancy options or switches. It just
  283. runs and prints the version on the screen. The syntax is as follows:
  284.  
  285.   PMWVER <filename>
  286.  
  287. where <filename> is the path name of the PMODE/W program you wish to check. It
  288. can also be run on PMODEW.EXE itself.
  289.  
  290. ------------------------------------------------------------------------------
  291. ----------------------- End of Utilities Documentation -----------------------
  292. ------------------------------------------------------------------------------
  293.  
  294.