Command: join / subst / swsubst

  FreeDOS uses SWSUBST instead of SUBST and JOIN.
  SWSUBST combines subst with join with enhanced options.
  SWSUBST replaces a path by a drive letter so that you have access to
  a path via a drive letter.

Syntax:

  swsubst [option] [command]
  If swsubst is used without specifying a command, the CDS table is
  displayed.

Options:

  /#     View the statistic of JOIN'ed drives in the CDS table.
  /!     Like /#; initialize the JOIN-flag, if it differs.
  /f     View non-printable characters hexadecimal.
  /a     View the CDS table after the command.
  /k     Create the paths mentioned within the command.
  /t     Like /k, in SUBST check only, if path exists.
  /_     Dump all attributes within the CDS table.
  /o=#   Use this backslash offset, do not calculate itself.
  /x=??  List of drive letters to be ignored while a ::label: search

  Without command: displays the CDS table.
  Commands:
  -                      Initialize all SUBST'ed and JOIND'ed drives.
  --                     Initialize all non-networked drives.
  dr [-]path             Like /u dr [-]path.
  /u dr [-]path          Substitute dr to point to path.
  /j dr [-]path          Join dr into path.
  /d dr | dr /d | dr -   Initialize drive dr (and break SUBST/JOIN).
  /s dr1 dr2             Swap dr1 and dr2.
  /n [dr1 dr2]           Swap unit numbers of the same device driver
                         (Std.: floppies).
  /w dr                  Set ERRORLEVEL to the drive letter of drive.
  /m [-]path             Create path including all leading up-directories.
  /c [-]path             Like /m, then chdir into it.
  dr:[+-=]{off,on,phys,net,join,subst,hidden}  Set drive flags directly.
  /q dr:[+-]{phys,net,join,subst,hidden}       Query the drive flags.

Comments:

  The DOS-standard emulating entities of SWSUBST, SUBST and JOIN, have
  the same command line as DOS's have. But they differ in the following
  points:
    - The specified path will be make'ed, including the full path to it,
      e.g. "SUBST c: d:/blah/humpf" creates the path "d:\blah\humpf",
      regardless of if d:\blah exists.
    - You are allowed to break off relations on the fly, that means:
      an already SUBST'ed can be re-SUBST'ed or re-JOIN'ed without
      further note/warning.
    - You are allowed to process a drive with itself, e.g.: "JOIN a:
      a:\blah"
    - The table dump is different, swsubst prints "X: => Y:\PATH" instead
      of "X: is joined to Y:\PATH".
    - You cannot rename the executables SUBST and JOIN.
    - It won't test the DOS version, unless it's necessary for adjusting
      different data structure sizes.
  If you need SUBST or JOIN simply execute: "copy SWSUBST.EXE JOIN.EXE
  or SUBST.EXE".
  An ERRORLEVEL between 65 (ASCII 'A') and 90 (ASCII 'Z') indicates OK
  and the drive letter itself; whereas an ERRORLEVEL of zero indicates,
  that there is no such drive; and other ERRORLEVELS indicate an error.

Examples:

  swsubst b: c:\blah\humpf

See also:

  assign
  errorlevel
  join
  subst
  truename

  Copyright © 1995 Steffen Kaiser, updated 2008 and 2022 by W. Spiegl.

  This file is derived from the FreeDOS Spec Command HOWTO.
  See the file H2Cpying for copying conditions.