Command: shsucdx
SHSUCDX is an unloadable CD-ROM redirector substitute for MSCDEX.
It supports up to 10 drives. Each drive is single-sector buffered and
the last 10 directory entries are cached. Each unit from each driver
can be assigned a specific drive letter.
Syntax:
shsucdx /D[:][?|*]driver[,[letter][,[unit][,[max]]]] [switches]
DRIVER is the name of the device driver installed to control
the CD-ROM drive. Prefixing the driver with '?' will
silently ignore it if it does not exist (or is not actually a
CD-ROM); prefixing with '*' will also ignore it, but a
drive will be reserved (see below).
LETTER is the first drive letter to assign to the units on
this driver. The default is the first available letter.
Note: the drive letters assigned to subsequent units will
always be higher than those assigned to previous units.
UNIT is the first unit on this driver to be assigned a drive.
Unit 0 is the default.
MAX is the maximum number of units on this driver to be assigned
drives. The default is all units (or all remaining units, if
UNIT is given).
Options:
/D Driver: This option is used to specify the name of the device
driver. It can also indicate which unit(s) should be assigned and
to what letter.
Drive manipulation: At install time, /D can also be used to
reserve space for additional drives. Use a single digit to indicate
how many drives should be reserved (eg: /D1). (If you should happen
to have a device driver name with a single digit, use the '?'
prefix.) After installation, the same option will remove the
drive(s) that were last assigned. It is possible to specify both
forms of /D, in which case the current drive(s) will be removed,
then the new drive(s) added. You can only use a drive letter which
is smaller or even with the letter in LASTDRIVE / LASTDRIVEHIGH.
/L Letter: This option is an alternative to the LETTER component of
/D, which it must follow (ie: /D:driver /L:letter). It can also be
used to return the number of drives installed (/L:0, will return 255
if not installed) and the letter of each assigned drive (/L:1, /L:2,
etc., with A: = 1 and 255 if the drive is not assigned). You can only
use a drive letter which is smaller or even with the letter in
LASTDRIVE / LASTDRIVEHIGH.
/C Uses conventional instead of high memory.
/V Memory statistics: When this option is used at installation, a
summary of memory usage will be displayed. This summary includes:
Static Code and variables
Dynamic Data for each drive and paragraph rounding
Total Overall memory usage
Information: When used with /?, or after installation, this
option displays the compile- and run-time options of SHSUCDX. This
information includes:
8086/386 The minimum processor required
CD root form TRUENAME will return \\D.\A.\ instead of D:\
High Sierra The original format for the CD file system
Joliet The Windows format for long names
Image on CD Enables access to an image which is itself on a CD
/~ Tilde usage: The ISO standard allows for CDs to have names up to
31 characters and Joliet can have names up to 64 characters. When
this is reduced to 8.3 for DOS it may lead to duplicated entries.
This option will remove the duplication by appending a tilded
number after the name (similar to what Windows does). By default,
tildes are off.
This option is also available after installation. By itself it will
toggle the status (ie. if tildes are currently on, /~ will turn
them off and vice versa). Tildes can be explicitly turned on or
off by adding a '+' or '-' sign (ie: /~+ will turn tildes on,
irrespective of the current state). You do not have these problems
when using the program DOSLFN.
/R Removes Read-only attribute.
/I Install anyway even if another redirector is present.
/U Unloads the shsucdx driver from memory.
/Q Quiet. Prevents display of the sign-on banner (copyright notice).
Comments:
SHSUCDX has the following EXITCODES (ERRORLEVEL):
0 Uninstalled, help, option set
1-32 Drive number of first installed drive (A=1)
246 Invalid or unknown option
247 Unable to uninstall
248 Not enough memory
249 No drives assigned (ie. not installed)
250 No drive letters available
251 Unit on driver does not exist
252 Invalid or non-existant driver
253 Already installed
254 Unsupported version of DOS
255 386 required
Examples:
IN CONFIG.SYS / FDCONFIG.SYS:
DEVICE=XCDROM.SYS /D:SHSU001
IN AUTOEXEC.BAT:
SHSUCDX /D:SHSU001
Exymple with several CD-ROM drives:
In CONFIG.SYS /FDCONFIG.SYS:
MENU 1. FreeDOS
MENU 2. FreeDOS + IDE CD-ROM (XDROM)
MENU 3. FreeDOS + USB CD-ROM (NOVAC)
MENU 4. FreeDOS + ASPI CD-ROM (SCSI AIC-75XX 78XX)
MENU 5. FreeDOS + IDE CD-ROM + USB CD-ROM + ASPI CD-ROM
lastdrivehigh=U
25?DEVICEHIGH=\fdos\bin\xcdrom.sys /D:IDE-CD
35?DEVICEHIGH=\fdos\drivers\usb\usbaspi.sys
35?DEVICEHIGH=\fdos\drivers\usb\usbcd.sys /D:USB-CD
45?DEVICEHIGH=\fdos\drivers\aspi\aspi8dos.sys
45?DEVICEHIGH=\drivers\scsi\aspicd.sys /D:ASPICD
In AUTOEXEC.BAT:
SHSUCDX /D:IDE-CD,R /D:*ASPICD,S /D:?USB-CD,U /L:0
See also:
(atapicdd.sys)
autoexec.bat
config.sys
doslfn
fdconfig.sys
(gcdrom.sys)
lastdrive
lastdrivehigh
(mscdex)
(udvd.sys)
uide.sys
(xcdrom.sys)
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.
Copyright © 2003-2004 Robert Platt, updated 2011 by W. Spiegl.
This file is derived from the FreeDOS Spec Command HOWTO.
See the file H2Cpying for copying conditions.