# Command: join

      FreeDOS uses SWSUSBST instead of 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.

#### [Main menu] [top] (Syntax) [Options] [Comments] [Examples] [See also] [File]

## 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 pathes mentioned within the command.
      /t     Like /k, in SUBST check only, if path exist.
      /_     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
      Commands:
      -                      Initialize all SUBST'ed and JOIND'ed drives.
      --                     Initialize all non-networked drives.
      dr [-]path             Like %s 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.

#### [Main menu] [top] [Syntax] (Options) [Comments] [Examples] [See also] [File]

## 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 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 JOIN simply execute: "copy SWSUBST.EXE JOIN.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.

#### [Main menu] [top] [Syntax] [Options] (Comments) [Examples] [See also] [File]

## Examples:

      swsubst b: c:\blah\humpf

#### [Main menu] [top] [Syntax] [Options] [Comments] (Examples) [See also] [File]

## See also:

      assign
      subst
      swsubst
      truename

#### [Main menu] [top] [Syntax] [Options] [Comments] [Examples] (See also) [File]

## File:

      Please read this command's lsm file also.
      You will find the updated version (internet) here and
      the version described in this manual page here.
      The lsm file contains information about the name of the programmer,
      the download site, and some other command related information.

#### [Main menu] [top] [Syntax] [Options] [Comments] [Examples] [See also] (File)

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

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