Command: shsurdrv
SHSURDRV simulates a floppy or hard disk using an image file in memory
and/or create a RAM drive.
Syntax:
SHSURDRV [/F[?][image][,drive]]... [/R[mem]] [/T] [/C] [/V] [/U] [/Q[Q]]
[/D[size][Ssectors][Ccluster][Dentries][Ffats][$[label]],][drive]]...
Options:
image Filename of raw disk image ('?' will ignore an invalid image)
or letter and colon to mirror a (floppy) drive (default is A:)
The image may have been compressed with gzip.
drive Drive letter to use (default is first available).
size Create a new drive with this much free space, in bytes;
suffix with 'K' for KiB or 'M' for MiB.
sectors Use exact number of sectors as size (default is 4101).
cluster Cluster size to use, in KiB (default is 4096 bytes).
entries Number of root directory entries (default is 64).
fats Number of File Allocation Tables (default is 1, max. of 2).
label The volume label (default is "SHSURDRV").
/R Reserve mem KiB of XMS (default is 4).
/T Allocate at the top of XMS.
/C Use conventional memory instead of loading high.
/V Display memory usage (only at install).
/U Unload.
/Q Quiet - don't display sign-on banner.
/QQ Really quiet - don't display anything.
Comments:
* A colon (':') can be used to separate an option from its value.
* Using /F and /D is optional; if the first character is a digit /D
will be assumed, otherwise /F.
* Options to /D may be separated by commas and appear in any order,
but size, if present, must be first.
* Size can be a predefined value - use "/?S" to see what is available.
* Cluster must be a power of 2 (ie. 0, 1, 2, 4, 8, 16, 32 or 64), any
other value will be rounded up to the next, but no higher than 64.
* Size will be rounded up to a multiple of the cluster size.
* Entries will be rounded up to a multiple of 16.
* Using more than 14 MiB of XMS requires /R or /T to start Windows,
which also doesn't like individual drives greater than 64 MiB.
* No drive letter will be assigned lower than the first.
Eg: /F:img1,E /F:img2,D will assign to E: and F:, *not* E: and D:.
* Only the drive (on the first partition of a hard disk) is simulated,
not the disk itself, and only a 512-byte sector size.
SHSUFDRV / SHSURDRV has the following ERRORLEVEL / EXITCODES:
0 On successful uninstall or this help is displayed;
1-32 The first drive assigned (A: = 1) on successful install;
255 Not able to (un)install.
Examples:
Create a diskette image:
diskcopy a: C:\example\diskette.img
SHSURDRV /F:?C:\example\diskette.img,H /W /V
H:
dir (shows content)
See also:
diskcopy
dskimg/ospimg
errorlevel/exitcode
raread
rawrite
shsufdrv
Copyright © 2008 W. Spiegl.
This file is derived from the FreeDOS Spec Command HOWTO.
See the file H2Cpying for copying conditions.