home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / subst120.lzh / SUBSTP.DOC < prev    next >
Text File  |  1994-11-28  |  7KB  |  196 lines
  1. SUBST for OS/2 2.x/3.0, Version 1.20, Mon  94-11-28
  2. ===================================================
  3.  
  4. Quick install:
  5.  
  6.     [config.sys]
  7.     ifs=SubstFsd.Ifs
  8.     run=Substhst.exe
  9.  
  10.     [startup.cmd]
  11.     REM make an alias for D:\OS2:
  12.     substp X: D:\os2
  13.  
  14.  
  15. Version 1.20 fixes a problem when using 4OS2 (redirection did not work
  16. properly).
  17.  
  18. Tested with OS/2 3.0 Warp (no changes were made to make it Warped).
  19.  
  20.  
  21. Note:  This program (and all other IFS's that "loop back" to a local
  22. file system) add overhead to all file i/o,  since all buffers must be
  23. "staged" through an application program (ring 3).  If you find yourself
  24. using SUBST to organize your data (ie: you use it every day),  keep this
  25. in mind;  you might want to use a real drive letter instead.
  26.  
  27. Although it is the property of A:WARE Inc,  there is no charge for the
  28. use of this program.  Consider it a "calling card"; please contact
  29. A:Ware Inc. for your commercial OS/2 programming (File system, device
  30. driver, display driver,  or application) needs.
  31.  
  32. SUBST for OS/2 2.x, Version 1.01, Tue  07-06-1993
  33. -------------------------------------------------
  34.  
  35. New features:  - Supports OS/2 2.0+ only.
  36.                - Now works with WorkplaceShell "drives" folder.
  37.                - Now works with "4OS2".
  38.                - Fixed various problems.
  39.                - Alternate SUBSTP syntax (like Novel MAP command).
  40.                - SUBSTP, when no command line parameters are given, will
  41.                  report information about all drive letters on your
  42.                  system.
  43.                - SUBST to an already SUBSTed drive.
  44.                - Automatic reassignment of an existing drive letter (no
  45.                  need to delete the drive letter first).
  46.  
  47. This program was written as an exercise to learn about IFS's
  48. (Installable File Systems).  It provides the same function as the
  49. old DOS command: SUBST.
  50.  
  51. Although it is the property of A:WARE Inc,  there is no charge for the
  52. use of this program.  Consider it a "calling card"; please contact
  53. A:Ware Inc. for your commercial OS/2 programming (File system, device
  54. driver, display driver,  or application) needs.
  55.  
  56. The program is broken into four parts:
  57.  
  58. SUBSTFSD.IFS  -- The FSD (File System Driver) which must be
  59.                  installed in CONFIG.SYS with the IFS= statement.
  60.  
  61. USUBST.DLL    -- This is provided to conform to the IFS specification.
  62.                  Each FSD is supposed to supply a DLL that is named
  63.                  "U<file system name>.DLL",  to support CHKDSK, FORMAT,
  64.                  etc.  UHPFS.DLL, UCDFS.DLL and ULAN.DLL are other
  65.                  examples.
  66.  
  67.                  USUBST.DLL simply prints a message saying that "The
  68.                  SUBST file system does not support the XXXXX
  69.                  command."   It is not a required part of the SUBST
  70.                  system.  You can loose it if you want. :-).
  71.  
  72. SUBSTHST.EXE  -- The file system host program,  which must be
  73.                  running at all times to use SUBSTituted drives.  It
  74.                  can be started in one of three ways:
  75.  
  76.                  1) RUN=SUBSTHST.EXE in config.sys
  77.                  2) DETACH SUBSTHST
  78.                  3) START SUBSTHST
  79.  
  80.                  The third method will allow you to see any messages
  81.                  the program may display.  Starting it with the /v
  82.                  (verbose) switch causes it to print out a LOT of
  83.                  information (this also causes it to run more
  84.                  slowly).   If you experience a problem,  running it
  85.                  with the /v switch may help discover where the
  86.                  problem is.
  87.  
  88.                  The new /v2 switch prints the same information as /v,
  89.                  but buffers the messages,  so that it will not slow
  90.                  things down as much.
  91.  
  92.                  This program may be terminated at any time (with
  93.                  ^C, for example) and restarted.  When it
  94.                  terminates, it automatically detaches all of the
  95.                  drives attached to it.
  96.  
  97. SUBSTP.EXE   -- The program you use to do the substitutions
  98.                 (attaches).
  99.  
  100. Displaying SUBSTed drives
  101. =========================
  102.  
  103.     SUBSTP      (no parameters)
  104.  
  105.                 - List all drive letters, with their associated file
  106.                 system.
  107.  
  108. Creating a SUBSTed drive
  109. ========================
  110.  
  111.   a) SUBSTP x: d:\path  (like MSDOS Subst command)
  112.    or
  113.   b) SUBSTP x:=d:\path  (novel "MAP" like sytax)
  114.  
  115.                 - Create an alias, X:,  for "D:\Path".   Doing "DIR X:\"
  116.                 would list the files in "D:\path".
  117.  
  118. Deleting a SUBSTed drive
  119. ========================
  120.  
  121.   a) SUBSTP x: /d
  122.    or
  123.   a) SUBSTP delete x:
  124.  
  125.                 - Delete (detach) substed drive letter.
  126.  
  127. Caveats:
  128. --------
  129.  
  130. Direct disk access via DosDevIOCtl() is not supported.  It doesn't
  131. really make sense to support it.
  132.  
  133. A SUBSTed drive has all of the properties and limitations of a LAN
  134. drive;  in fact,  OS/2 thinks it is a "remote" drive.
  135.  
  136. Do not try to use a drive letter that is already being used by the DOS
  137. BOX subst command (OS/2 1.x).  This will probably cause a system crash.
  138. Instead,  use only this program -- although the DOS BOX can't run
  139. SUBSTP.EXE,  it DOES have access to all of the drives SUBSTed by an OS/2
  140. session.
  141.  
  142. DISCLAIMER
  143. ----------
  144. The Program is supplied "AS IS" without any warranty of any kind,
  145. either expressed or  implied,  including, but not limited to, the
  146. implied warranties of merchantabilty and fitness for a particular
  147. purpose.
  148.  
  149. In  no  event  shall A:WARE INC be liable for any damages, either
  150. direct or  consequential,  caused by the use, or inability to use,
  151. this program, even  if A:WARE INC has been advised of the
  152. possibility of such damages.
  153.  
  154. WARRANTY
  155. --------
  156. This program has no warranty.  It is a completely unsupported
  157. product.  Bug reports/suggestions will be listened to,  but not
  158. necessarily acted upon.
  159.  
  160.                         --------
  161.  
  162. The FSD code runs in "kernel protect mode" (ring 0).  If there is a
  163. bug in it,  you'll get the dreaded register dump and "The system
  164. detected an internal processing error at xxxx:yyyy.  The system is
  165. stopped".   Only one code segment is used by this FSD,  so it will
  166. be easy to find out if this program is to blame if your system
  167. crashes.   If the CS register is equal to the value that
  168. SUBSTHST.EXE displays when it is first started,  then SUBSTFSD.IFS
  169. caused the crash.  Note that the CS value is displayed in the
  170. register dump,  NOT in the 'xxxx' in the message "The system
  171. detected an internal processing error at xxxx:yyyy."
  172.  
  173. Neither of the two *.EXE programs supplied are capable of crashing
  174. the system,  since they run at Ring 3.
  175.  
  176. Performance
  177. -----------
  178. Using a SUBSTed drive is slower than using one that isn't.
  179.  
  180.                         --------
  181.  
  182. Copyright (C) 1991, 1993 A:WARE Inc.
  183.  
  184. A:WARE Inc. develops custom OS/2 applications,  device drivers,  and
  185. utilities.
  186.  
  187. A:WARE Inc.
  188. 6056 Cayeswood Ct.
  189. Mississauga Ontario
  190. Canada L5V-1B1
  191.  
  192. Voice: (905)858-3222
  193. FidoNet: 1:259/414
  194. BBS: (905)858-8488
  195.  
  196.