home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / mass61.zip / mass.zip / masm61 / DISK3 / BIN / SMARTDRV.DO$ / SMARTDRV
Text File  |  1992-03-18  |  15KB  |  355 lines
  1.  
  2.                                SMARTDRV.DOC File
  3.  
  4.                   (C) Copyright Microsoft Corporation, 1992
  5.  
  6.  
  7. ================================< Contents >=================================
  8.  
  9.   
  10.      This file has 2 parts:
  11.   
  12.                Part     Contents
  13.                ----     --------
  14.                1        Using the SMARTDRV.EXE Disk-Caching Program
  15.  
  16.                2        Additional Notes
  17.  
  18.  
  19.  
  20. =============< Part 1: Using the SMARTDRV.EXE Disk-Caching Program >=========
  21.  
  22.      Microsoft Macro Assembler includes SMARTDRV.EXE version 4.0, a
  23.      sophisticated block-oriented disk-caching program that significantly
  24.      improves assembly and link times. SMARTDRV.EXE is not required by MASM,
  25.      but it can reduce the amount of time your computer spends reading data
  26.      from your hard disk. SMARTDRV.EXE replaces the older version,
  27.      SMARTDRV.SYS, and is compatible with all versions of Windows 3.x.
  28.  
  29.      SMARTDRV.EXE sets aside some expanded or extended memory as a cache for
  30.      its own use. SMARTDRV.EXE uses this disk cache to store the information
  31.      read from the hard disk when an application needs information from your
  32.      hard disk. When an application attempts to read additional information
  33.      from the hard disk, the SMARTDRV.EXE program supplies the information
  34.      directly from its cache instead. If you are using RAMDRIVE.SYS to create
  35.      one or more RAM drives, and are limiting the memory assigned to
  36.      SMARTDRV.EXE as a result, you can increase system speed by reassigning
  37.      some or all of the memory away from the RAM drive and adding it to the
  38.      memory available to SMARTDRV.EXE.
  39.  
  40.      SMARTDRV.EXE automatically loads itself into HMA under MS-DOS 5.0 if
  41.      EMM386.EXE is loaded and upper-memory blocks are available as a result of
  42.      a DOS=UMB or DOS=UMB,HIGH command in your CONFIG.SYS file. SMARTDRV.EXE
  43.      can also be loaded into HMA with third-party memory managers such as
  44.      386-Max.
  45.  
  46.      SMARTDRV.EXE must be specified in both your AUTOEXEC.BAT file and
  47.      CONFIG.SYS file because there are actually two device drivers in a single
  48.      file: a double-buffer driver and a disk cache. The double-buffer driver is
  49.      installed in CONFIG.SYS, and the cache component of SMARTDRV.EXE is
  50.      installed in AUTOEXEC.BAT. Some disk controllers do not need double
  51.      buffering; using this option when you do not need it results in a small
  52.      performance penalty. Therefore, once your system is running with
  53.      SMARTDRV.EXE, type:
  54.  
  55.         SMARTDRV
  56.  
  57.      at the command-line prompt. SMARTDRV.EXE displays disk-cache status
  58.      information about your system that looks like this:
  59.  
  60.         Microsoft SMARTDrive Disk Cache version 4.0
  61.         Copyright 1991,1992 Microsoft Corp.
  62.  
  63.         Cache size: 1,048,576 bytes
  64.         Cache size while running Windows: 1,048,576 bytes
  65.  
  66.                         Disk Caching Status
  67.             drive   read cache   write cache   buffering
  68.             --------------------------------------------
  69.               A:       yes           no           no
  70.               B:       yes           no           no
  71.               C:       yes           yes          yes
  72.               D:       yes           yes          -
  73.  
  74.             For help, type "Smartdrv /?".
  75.  
  76.  
  77.      Note
  78.      ----
  79.      If every line in the Buffering column is No, then you can safely remove
  80.      the DEVICE statement for SMARTDRV.EXE from your CONFIG.SYS file.
  81.  
  82.      SMARTDRV.EXE always copies data to your hard disk when you turn off  your
  83.      computer. It also writes all data to the disk when an application calls
  84.      the MS-DOS reset disk function. If you want to force data to be written to
  85.      disk, use the /C command-line option. If you use a third-party program to
  86.      reboot your machine from a batch file, you should make sure you have
  87.      SMARTDRV /C in the batch file prior to the reboot command. Failure to do
  88.      so may cause data loss.
  89.  
  90.      You can use command-line options to control the size of the cache element
  91.      (/E) and the size of the read-ahead buffer (/B). The read-ahead buffer is
  92.      additional information that SMARTDRV.EXE reads when the application reads
  93.      information from the hard disk. The size must be specified in bytes, and
  94.      the element size must be one of the following: 1024, 2048, 4096, or 8192.
  95.      The read-ahead buffer must be a multiple of the element size, cannot be
  96.      less than the element size, and cannot exceed 32768. The defaults are 8192
  97.      for the element size and 16384 for the read-ahead buffer. Because these
  98.      will occupy conventional or UMB memory space, making them larger reduces
  99.      the memory MS-DOS applications have available.
  100.  
  101.      You can start the SMARTDRV.EXE program by typing SMARTDRV at the MS-DOS
  102.      prompt before you start Windows, or by placing a command line in your
  103.      AUTOEXEC.BAT file. The syntax is:
  104.  
  105.         [[drive:]] [[path]]SMARTDRV.EXE[[ [[drive[[+|-]] ]]...]]
  106.                                   [[/E:ElementSize]] [[InitCacheSize]]
  107.                                   [[WinCacheSize]] ]] [[/B:BufferSize]]
  108.                                   [[/C]] [[/R]] [[/L]] [[ /Q]] [[/S]] [[/?]]
  109.  
  110.  
  111.      The following list describes the command-line options available for
  112.      SMARTDRV.EXE:
  113.  
  114.      drive
  115.      -----
  116.      Specify the letter of the disk drive for which you want to
  117.      control caching. If you don't specify a drive letter, floppy disk
  118.      drives are read-cached but not write-cached, hard disk drives
  119.      are read- and write-cashed, and CD-ROM and network drives
  120.      are ignored. You can specify multiple disk drives.
  121.  
  122.      path
  123.      ----
  124.      Specify the location of the SMARTDRV.EXE file.
  125.  
  126.      + | -
  127.      -----
  128.      Enable (+) or disable (-) caching. Use the plus (+) and minus (-)
  129.      signs to override the default settings. If you specify a drive let-
  130.      ter without a plus or minus sign, read-caching is enabled and
  131.      write-caching is disabled. If you specify a drive letter followed
  132.      by a plus sign (+), read- and write-caching are enabled. If you
  133.      specify a drive letter followed by a minus sign(-), read- and
  134.      write-caching are disabled.
  135.  
  136.      /E:ElementSize
  137.      --------------
  138.      Specify in bytes the amount of the cache SMARTDRV.EXE
  139.      moves at a time. This must be greater than or equal to 1, and a
  140.      power of 2. The default value is 8K.
  141.  
  142.      InitCacheSize
  143.      -------------
  144.      Specify the size in kilobytes of the cache when
  145.      SMARTDRV.EXE starts (before Windows is running). The
  146.      size of the disk cache affects SMARTDRV.EXE's efficiency. In
  147.      general, the larger the cache, the less often SMARTDRV.EXE
  148.      needs to read information from the disk, which speeds up your
  149.      system's performance. If you do not specify an InitCacheSize
  150.      value, SMARTDRV.EXE sets the value according to how
  151.      much memory your system has (see the list following this list).
  152.  
  153.      WinCacheSize
  154.      ------------
  155.      Limit the amount (in kilobytes) Windows can reduce the cache
  156.      size. Windows reduces the size of the cache to recover memory
  157.      for its own use. Windows and SMARTDRV.EXE then cooper-
  158.      ate to provide optimum use of your system memory. When you
  159.      quit Windows, Windows restores the cache to its normal size.
  160.      The default value depends on how much available memory
  161.      your system has (see the list following this list). If you specify a
  162.      value for InitCacheSize that is smaller than the value specified
  163.      for WinCacheSize, InitCacheSize is set to the same size as
  164.      WinCacheSize.
  165.  
  166.      /B:BufferSize
  167.      -------------
  168.      Specify the size of the read-ahead buffer. The next time the
  169.      application is to read information from that file, it can read it
  170.      from memory instead. The default size of the read-ahead buffer
  171.      is 16K. Its value can be any multiple of ElementSize.
  172.  
  173.      /C
  174.      --
  175.      Write all cached information from memory to the hard disk.
  176.      SMARTDRV.EXE writes information from memory to the hard
  177.      disk at times when other disk activity has slowed. You might
  178.      use this option if you are going to turn off your computer, and
  179.      you want to make sure all cached information has been written
  180.      to the hard disk.
  181.  
  182.      /R
  183.      --
  184.      Clear the contents of the existing cache and restart
  185.      SMARTDRV.EXE.
  186.  
  187.      /L
  188.      --
  189.      Prevent SMARTDRV.EXE from loading into upper-memory
  190.      blocks (UMBs), even if there are UMBs available. You can use
  191.      this option of you are using MS-DOS version 5.0 or later and
  192.      UMBs are enabled.
  193.  
  194.      /Q
  195.      --
  196.      Prevent the display of SMARTDRV.EXE information on your
  197.      screen.
  198.  
  199.      /S
  200.      --
  201.      Display additional information about the status of
  202.      SMARTDRV.EXE.
  203.  
  204.      /?
  205.      --
  206.      Display online Help about the SMARTDRV.EXE command
  207.      and options.
  208.  
  209.  
  210.      The following list shows the default values for InitCacheSize and
  211.      WinCacheSize, depending on the amount of available extended memory on your
  212.      computer.
  213.  
  214.      Extended Memory   <= 1 MB     <=2 MB     <=4 MB    <=6 MB    <=6 MB
  215.  
  216.      InitCacheSize     All         1 MB        1 MB      2 MB     2 MB
  217.      WinCacheSize      Zero        256K        512K      1 MB     2 MB
  218.  
  219.  
  220.      Note
  221.      ----
  222.      Do not put the SMARTDRV.EXE cache in the expanded memory provided by
  223.      EMM386.EXE. EMM386.EXE uses extended memory to emulate expanded memory
  224.      that other programs can use. Although SMARTDRV.EXE can use this emulated
  225.      expanded memory for its cache, it may not make your program run as quickly
  226.      as it would using extended memory.
  227.  
  228.      Because the optimal cache size for SMARTDRV.EXE depends on the programs
  229.      you run, and on your system configuration, there is no single best
  230.      setting. You should experiment to find the best cache size for your system
  231.      after saving a copy of your CONFIG.SYS file. For more information, see
  232.      your Windows User's Guide.
  233.  
  234.  
  235. =========================< Part 2: Additional Notes >=========================
  236.  
  237.  
  238.      Avoiding Data Loss When Using SMARTDRV.EXE
  239.      ------------------------------------------
  240.  
  241.      SMARTDRV.EXE does not write data to disk immediately. If your computer
  242.      should crash after the time data is written to the cache and before
  243.      the data is written to the disk, data can be lost. Issuing the
  244.      following command causes SMARTDRV to write all data in the cache to
  245.      the disk:
  246.  
  247.      SMARTDRV /c
  248.  
  249.  
  250.      Setup May Not Detect Foreign Disk Cache
  251.      ---------------------------------------
  252.      Setup may install SMARTDRV.EXE if it does not detect the foreign 
  253.      disk cache installed on your system. Remove the DEVICE statements 
  254.      for SMARTDRV.EXE from your AUTOEXEC.BAT and CONFIG.SYS files to 
  255.      resolve this problem.
  256.  
  257.  
  258.      Programs That May Be Incompatible with SMARTDRV.EXE
  259.      ---------------------------------------------------
  260.  
  261.      The following applications may be incompatible with SMARTDRV.EXE,
  262.      version 4.0:
  263.  
  264.      - The Disk Protect feature in Norton Utilities version 6.0
  265.  
  266.        Do not use the Disk Protect feature in Disk Monitor. If you do,
  267.        you will encounter an error and your system may hang if you try
  268.        to write to the protected drive. If you want to write to and
  269.        cache a protected drive, use the Norton cache program when using
  270.        Disk Monitor.
  271.  
  272.      - The Calibrate program in Norton Utilities version 6.01
  273.  
  274.        Calibrate fails on the Disk Mapping test if SMARTDRV is enabled.
  275.  
  276.      - DoubleDisk from Vertisoft
  277.  
  278.        Do not enable write-behind caching for DoubleDisk compressed
  279.        partitions.
  280.  
  281.      - Storage Dimensions SCSI Driver (SSTOR.SYS)
  282.  
  283.        Using the SSTOR.SYS driver, the SCSI drive appears corrupted when
  284.        SMARTDRV is loaded. The disk's contents are not altered, but they
  285.        are inaccessible when using SMARTDRV.
  286.  
  287.      The following drivers, installed in a CONFIG.SYS file, are
  288.      incompatible with SMARTDRV.EXE version 4.0:
  289.  
  290.      - The SuperStor utility from Addstor (SSTORDRV.SYS)
  291.  
  292.        Do not use the Create Mountable Drive or Mount and Dismount features
  293.        of SuperStor after SMARTDRV is loaded. You must configure your
  294.        SuperStor partitions before loading SMARTDRV. If your AUTOEXEC.BAT
  295.        file includes "mount" configuration commands, make sure that the
  296.        SMARTDRV command line follows the SuperStor configuration command
  297.        lines.
  298.  
  299.        Also, you will receive read-write errors if you use SMARTDRV to
  300.        cache a SuperStor compressed drive. To prevent SMARTDRV from
  301.        caching the compressed drive, you must include the driver letter-
  302.        option on the SMARTDRV command line.
  303.  
  304.        For example, if drive C is the uncompressed drive, and drives E
  305.        and F are the compressed SuperStor drives, you would type the
  306.        following command line or include it in your AUTOEXEC.BAT file:
  307.  
  308.        smartdrv e- f-
  309.  
  310.      - The network driver from DNA Networks Inc. (STATION.SYS)
  311.  
  312.        Using both STATION.SYS and SMARTDRV may cause your system to hang.
  313.  
  314.      - Versions prior to version 7.x of the driver for the
  315.        Bernoulli Box (RCD.SYS)
  316.  
  317.        The RCD.EXE program requires that driver RCD.SYS be installed to
  318.        use the Bernoulli Box. When SMARTDRV is running, RCD.EXE does
  319.        not recognize that RCD.SYS has been installed.
  320.  
  321.      - The Norton Antivirus utility (NAV_.SYS and NAV&.SYS)
  322.  
  323.        The NAV_.SYS and NAV&.SYS drivers for the Norton Antivirus utility
  324.        may generate "Not enough memory" errors or hang your system when
  325.        loading SMARTDRV.EXE. One workaround is to use the /L command-line
  326.        option to load SMARTDRV.EXE into low memory. An alternative is using
  327.        the /B option with NAV&.SYS to avoid the NAV&.SYS bug that causes
  328.        your system to hang.
  329.  
  330.      The following driver, installed in an AUTOEXEC.BAT file, is
  331.      incompatible with SMARTDRV.EXE version 4.0:
  332.  
  333.      - DataMonitor version 7.1 by PC Tools (DATAMON.*)
  334.  
  335.        Loading DataMonitor after SMARTDRV is installed may cause your
  336.        system to hang.
  337.  
  338. =============================================================================
  339.  
  340.      Microsoft, MS, MS-DOS, and CodeView are registered trademarks, and
  341.      Windows is a trademark of Microsoft Corporation.
  342.  
  343.      386-Max is a trademark of Qualitas, Inc.
  344.  
  345.      Bernoulli Box is a trademark of Iomega Corporation.
  346.  
  347.      Norton Utilities is a registered trademark of Peter Norton Computing.
  348.  
  349.      SuperStor is a trademark and Addstor is a registered trademark of
  350.      Addstor, Inc.
  351.  
  352. NOTE: Microsoft improves its languages documentation at the time of
  353.       reprinting, so some of the information in this file may already be
  354.       included in your manuals.
  355.