FreeDOS help system (hhstndrd 1.0.8 en)[subst]

Command: subst

FreeDOS uses SWSUBST instead of SUBST. 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 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 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 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 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 join swsubst truename ------------------------------------------------------------------------------ Copyright (C) 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.