home *** CD-ROM | disk | FTP | other *** search
/ Boldly Go Collection / version40.iso / TS / 10A / DOSMAX15.ZIP / FREELOAD.DOC < prev    next >
Text File  |  1992-04-04  |  9KB  |  241 lines
  1.  
  2. ================================================================================
  3.         FREELOAD.SYS :  Ver. 1.4, Copyright (1992) by Philip B. Gardner
  4. ================================================================================
  5.  
  6.   FREELOAD.SYS is a device driver which will help maximize the use of low
  7.   memory by releasing memory usually reserved in low memory by LOADHI.SYS
  8.   from Quarterdeck Office Systems. 
  9.  
  10.   FREELOAD.SYS tracks the high memory device loader operations and if it
  11.   is safe to release the low memory after each device initiates, the low
  12.   memory is released and the driver in upper memory is linked into the DOS
  13.   device chain.
  14.  
  15.   FREELOAD.SYS can be used to save 1-2k in a typical configuration.  The
  16.   actual amount of memory saved depends upon on the number and type of
  17.   device drivers loaded high.
  18.  
  19.   Support is provided for:
  20.  
  21.     * specifying the name and path of the device loader
  22.     * both character and block devices
  23.     * character drivers which contain an unlimited number of devices
  24.     * DOS Versions 3.1 - 3.31, DOS 4.x, and DOS 5.x (or better?)
  25.  
  26. ================================================================================
  27.  
  28. (Requirements)::
  29.  
  30.         * 286 processor or better
  31.         * Requires MS-DOS Version 3.10 or better
  32.  
  33. ================================================================================
  34.  
  35. (Installation)::
  36.  
  37.         (CONFIG.SYS)::
  38.  
  39.         Installation of FREELOAD.SYS requires modifying the contents of
  40.         your CONFIG.SYS file.
  41.  
  42.         Add a DEVICE= line for FREELOAD.SYS in your config.sys.  FREELOAD
  43.         should be loaded immediately after the XMS and UMB memory manager
  44.  
  45.         DEVICE=(Memory Manager)
  46.         DEVICE=FREELOAD.SYS [options]
  47.  
  48.         The default loader pathname is "C:\QEMM\LOADHI.SYS".  If FREELOAD
  49.         cannot open this pathname, a message will displayed alerting you
  50.         to "Use /Fpathname to override."  An example which uses this switch
  51.         is shown below:
  52.  
  53.         DEVICE=FREELOAD.SYS /F D:\QEMM\LOADHI.SYS
  54.  
  55. (Tip)::
  56.  
  57.         If you prefer that a particular device driver is not affected by
  58.         the operation of FREELOAD, place the DEVICE= for that device above
  59.         the DEVICE=FREELOAD.SYS entry.  This may be necessary in the case
  60.         that a particular driver is not compatible with FREELOAD.
  61.  
  62. ================================================================================
  63.  
  64. (Syntax)::
  65.  
  66.         The only thing to remember about syntax for the command line is
  67.         that just about anything works.  What this means is that you
  68.         should be able to type in the options on the command line the
  69.         way they make sense to you.
  70.  
  71.         To illustrate this point, the following command line example
  72.         is mutated several different ways.
  73.  
  74.         DEVICE=FREELOAD.SYS /R+ /P+ /FC:\QEMM\LOADHI.SYS
  75.         DEVICE=FREELOAD.SYS -R+ -P+ -F C:\QEMM\LOADHI.SYS
  76.         DEVICE=FREELOAD.SYS R+ P+ F C:\QEMM\LOADHI.SYS
  77.         DEVICE=FREELOAD.SYS R+P+FC:\QEMM\LOADHI.SYS
  78.         DEVICE=FREELOAD.SYS -R+P+FC:\QEMM\LOADHI.SYS
  79.  
  80.         ... and so on.  There must be an EOL or space following the
  81.         filename paramter the /Fpathname switch
  82.  
  83. (Switch Options)::
  84.  
  85.         (REPORT)::      R[+ or -]       (toggle:  default -)
  86.  
  87.         Use /R+ to enable a report of the allocation status
  88.         of FREELOAD.SYS
  89.  
  90.         (PAUSE)::       P[+ or -]       (toggle:  default -)
  91.  
  92.         Use /P+ enable a pause after the above report
  93.  
  94.         (NOPAUSE)::     N[+ or -]       (toggle:  default -)
  95.  
  96.         Use /N+ to never pause after the report, even if there
  97.         are errors.  This switch can be used if your configuration
  98.         generates a warning or error message which you choose to ignore.
  99.  
  100.         (FILEPATH)::    F[pathname]     (string:  default C:\QEMM\LOADHI.SYS)
  101.  
  102.         Use /Fpathname to specify the filename and path of the device
  103.         loader provided with your upper memory manager.  For example, if
  104.         this device driver is on drive D:
  105.  
  106.                 DEVICE=FREELOAD.SYS /FD:\QEMM\LOADHI.SYS
  107.  
  108.         If FREELOAD cannot find this file, it will not load.
  109.  
  110.         (DRIVE TABLE SIZE)::    Dnn     (value:  nn = 88)
  111.  
  112.             Use /Dnn to set the Drive Table Size.  Values other than the
  113.         MS-DOS 4.0 - 5.0 Drive Table Size of 88 are only allowed if the
  114.         true MS-DOS version is greater than 5.0.  The Drive Table Size
  115.         for DOS 3.x is 81. The /Dnn switch is only necessary if FREELOAD
  116.         can't determine the Drive Table Size automatically.
  117.  
  118.         (SHRINK)::      S[+ or -]       (toggle:  default -)
  119.  
  120.         FREELOAD normally takes approximately 1K of high memory. Use /S+
  121.         to reduce this requirement to 16 bytes just before the shell is
  122.         loaded from CONFIG.SYS.  Shrinking may cause problems with high
  123.         memory optimizers, but the switch can be safely used after the
  124.         system is optimized, to free another 1K of high memory.
  125.  
  126.         *  everything in square brackets "[]" is optional
  127.  
  128. (CONFIG.SYS Line)::
  129.  
  130.         DEVICE=FREELOAD.SYS [/ or -][R[+]P[+]N[+]S[+]Fpathname]
  131.  
  132.         device mode default: /R-P-N-S-FC:\QEMM\LOADHI.SYS
  133.  
  134.         *  No Report status messages
  135.         *  No Pause after report
  136.         *  Pause on errors or warnings
  137.         *  Default Loader Pathname = "C:\QEMM\LOADHI.SYS"
  138.  
  139. ================================================================================
  140.  
  141. (Report Format)::
  142.  
  143.       FREELOAD.SYS :  Ver. 1.4, Copyright (1992) by Philip B. Gardner
  144.              ERROR :  (Error Messages)
  145.            WARNING :  (Warning Messages)
  146.             ADVICE :  (Advisory Messages)
  147.                    :  (Report Messages)
  148.                    :  (Allocation Status)
  149.              PAUSE :  Press any key to continue... 
  150.  
  151. ================================================================================
  152.  
  153. (Error Messages)::
  154.  
  155.         MS-DOS version 3.10 or above is required
  156.         XMS manager not installed
  157.         DOS version is not compatible
  158.         Can't load in High Memory
  159.         Device Loader not found
  160.  
  161. ================================================================================
  162.  
  163. (Warning Messages)::
  164.  
  165.         Unknown option in command line
  166.         Extra characters on command line
  167.         Drive Table Size not determined or out of range
  168.  
  169. ================================================================================
  170.  
  171. (Advisory Messages)::
  172.  
  173.         Use /Fpathname to override
  174.         Use /Dnn switch to set Drive Table size
  175.  
  176. ================================================================================
  177.  
  178. (Report Messages)::
  179.  
  180.         Drive Table Size set to 00h
  181.         [pathname]                      (/Fpathname parameter if error)
  182.  
  183. ================================================================================
  184.  
  185. (Allocation Status)::
  186.  
  187.         FREELOAD moved to 0000
  188.         Not enough Hi Memory for FREELOAD  
  189.  
  190. ================================================================================
  191.  
  192. (Changes)::
  193.  
  194.         (Version 1.1)::
  195.  
  196.         1) Fixed problem where character devices were skipped if a
  197.            block device was loaded first
  198.  
  199.         2) Added support for block devices.  This grew the size of
  200.            FREELOAD to 880 bytes so FREELOAD now shrinks to 16 bytes
  201.            when finished.  This frees a .8k block of upper memory
  202.            which is not needed after all devices are loaded.
  203.  
  204.         (Version 1.2)::
  205.  
  206.         1) Added support for character drivers which contain multiple
  207.            devices.  There is a requirement for 16 bytes of low
  208.            memory for a multiple device driver, but this 16 bytes
  209.            supports an unlimited number of devices within the driver.
  210.            Without the 16 bytes, DOS believes the initialization of the
  211.            driver has failed and only the first device is linked.
  212.  
  213.         (Version 1.3)::
  214.  
  215.         1) Fixed problem with failing to build a Drive Parameter Block
  216.            when a multiple device driver ended with a block device.
  217.  
  218.         2) Changed automatic reduce to a command line option.  FREELOAD
  219.            now takes 1K bytes high.  If the /S+ (shrink option is used)
  220.            this size is reduced to 16 bytes just before the shell is
  221.            loaded.
  222.  
  223.         (Version 1.4)::
  224.  
  225.         1) Improved multiple device failure mode.  If a multiple device
  226.            driver has begun the initiate phase and fails, the high device
  227.            is left unlinked, and the loader is left in place with memory
  228.            and the device chain set to the length of the last successful
  229.            initialization.  This method more closely emultates DOS.
  230.  
  231.         2) Added check that resets FREELOAD if the loader doesn't load the
  232.            device in high memory successfully.
  233.  
  234.         3) Optimized code to reduce memory requirement back to 1K
  235.  
  236.         (Version 1.5)::
  237.  
  238.         1) Added base 10 display of Drive Table Size message
  239.  
  240. ================================================================================
  241.