-
Notifications
You must be signed in to change notification settings - Fork 9
/
readme.txt
231 lines (178 loc) · 8.11 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
SHSUCD Suite
Copyright 2005-2022 Jason Hood
Freeware. Version 3-7
Derived from SHSUCD 1.4b by John McCoy
===========
Description
===========
The SHSUCD suite is a set of programs dealing with the CD-ROM. They
allow access to the CD-ROM as a normal drive letter; create an image
file from the contents of a CD-ROM; access an image file as a drive; and
test certain CD-ROM functions.
========
Programs
========
The following programs are included in the suite:
SHSUCDX v3.09 Provides access to the CD-ROM as a drive (MSCDEX)
SHSUCDHD v3.01 Simulates a CD-ROM using an image file
SHSUCDRD v1.00 Simulates a CD-ROM using an image file in memory
SHSUDVHD v1.00 Simulates a DVD-ROM using multiple image files
SHSUCDRI v1.01 Creates an image from a CD-ROM in memory
OMI v1.00 Creates an image from a CD-ROM or DVD-ROM
ISOBAR v1.01 Extracts the boot image from a bootable CD-ROM
CDTEST Tests the CD-ROM functions (Int2F/AH=15)
SMARTER Patches SMARTDrive 5.02 to cache SHSUCDX
=======
SHSUCDX
=======
SHSUCDX is a CD-ROM redirector (substitute for MSCDEX). It differs from
MSCDEX in that it can be unloaded, it occupies less memory and only sel-
ected units are mapped. It can also handle lowercase names and ISO long
names (where the 8.3 name would be duplicated). Please see SHSUCDX.TXT.
======================================
SHSUCDHD, SHSUCDRD, SHSUDVHD, SHSUCDRI
======================================
These programs are CD-ROM device drivers that emulate CD- or DVD-ROMs by
using image files (possibly in memory). The image file can be created
by OMI, or by any program that can generate a standard .ISO file (DVDs
can only be created by OMI). Please see IMAGE.TXT.
===
OMI
===
OMI (Optical Media Image) will create an image file from a CD-ROM, or
multiple files from a DVD-ROM. The image is a direct copy of the disc,
which can then be used by the above programs to access the CD/DVD with-
out needing the physical disc. Please see IMAGE.TXT.
======
ISOBAR
======
ISOBAR (ISO Boot Archive Remover) will display information about a boot-
able CD-ROM and optionally extract the floppy or hard disk image, or the
no emulation code. In multiple-image configurations, only the initial/
default image is recognised.
-----
Usage
-----
Without any options, ISOBAR will display the boot information for the CD
in the first CD-ROM drive. A drive letter (with or without a colon) or
an image file can be used to display information about another CD. To
actually extract the image, use "-o" followed by the filename to give
the image. By default, hard disk images will be extracted in full; add
"-d" to just extract the logical drive (ie. the partition).
-----------
Information
-----------
The boot information displayed is (all numbers are hexadecimal):
Catalog Sector Sector containing the El Torito boot catalog
Platform CPU required in order to boot
ID String String identifying the manufacturer/developer
Bootable Indicates the CD is bootable
Boot Type The medium emulated to achieve boot
Load Segment Memory address to load initial boot image
System Type The format of the partition
Sector Count The (emulated) sectors to store at Load Segment
Image Sector Sector containing the image
Image Size Size of the image in bytes (and decimal)
To convert the CD sector to an image file offset, multiply by 2048.
---------
Exit Code
---------
0 No problems
1 Unknown/invalid option
2 Not enough memory
3 Problem with CD (SHSUCDX not installed, drive is not a
CD-ROM, unrecognised format, no disc present)
4 Unable to create image file
5 Read/write error
======
CDTEST
======
CDTEST is a simple program to test the CD-ROM functions on interrupt 2F,
AH=15. It also tests the installation checks using AX=1100. It will
only work with SHSUCDX (and only this version, not earlier versions).
All functions 00 to 0F are tested (ie. including unsupported functions,
but excluding 10 device request). To test 0F directory entry, specify a
file name (which must be a complete path, including drive letter).
Since different CDs will yield different results, the output of each
function is displayed, rather than a "pass/fail" message, so manual
verification is necessary.
=======
SMARTER
=======
SMARTER will patch SMARTDrive 5.02 to enable it to cache SHSUCDX. If no
file name is specified, it will try SMARTDRV.EXE in the directory given
in the "winbootdir" environment variable, or C:\WINDOWS if that doesn't
exist. If the patch is successful, SMARTCDX.EXE will be created in the
current directory. Note that SMARTCDX is not capable of caching MSCDEX.
It is recommended the SMARTDRV line in CONFIG.SYS or AUTOEXEC.BAT be
duplicated and commented, modifying the copy to point to SMARTCDX.
---------
Exit Code
---------
0 SMARTCDX.EXE created OK, or help displayed
1 Could not open SMARTDRV.EXE or specified file
2 Not enough memory
3 Unrecognised SMARTDrive version
4 Could not create SMARTCDX.EXE
5 Could not write SMARTCDX.EXE
=========
Compiling
=========
I have used NASM 0.98.39 and Borland C++ 3.1. Due to my heavy use of
the NASM preprocessor, a 32-bit version is required, with about 6MB of
free memory (to avoid paging). I think version .36 may compile, but not
before that; series 2 will also not work (at least up until 2.15rc0).
Users of other C compilers should be able to compile SMARTER.C, but
the other C programs may need modifications (I've used REGPACK and intr,
which seems Borland-specific, so you'll have to split REGPACK into REGS
and SREGS and use int86x). Please see the MAKEFILE.
There's no need to tell me about UPX, but feel free to use it yourself.
Gzip decompression used by SHSUCDRD is from a modified zlib 1.2.1. The
compiled library is supplied with the suite, so zlib is not needed, un-
less you want to use a different compiler. My modifications to zlib are
in the SHSUCDRD.TXT patch file (apply with -p1). It's designed for Bor-
land; other compilers may require modification (to SHSUCDRD, as well).
=====
Files
=====
The following files are included in the package:
README.TXT This file
SHSUCDX.TXT Documentation for SHSUCDX
IMAGE.TXT Documentation for all the image programs
TODO.TXT List of possible remaining changes
SHSUCDX.COM MSCDEX replacement (386+)
SHSUCDHD.EXE Use an image file as a CD (386+)
SHSUCDRD.EXE Use an image file in memory as a CD (386+)
SHSUDVHD.EXE Use image files as a DVD (386+)
SHSUCDRI.EXE Create an image file in memory, use it as CD (386+)
OMI.EXE Create an image file from a CD or DVD
ISOBAR.EXE Extract the boot image from a bootable CD
CDTEST.EXE Test the CD functions (Int2F/AH=15)
SMARTER.EXE Patch to allow SMARTDrive 5.02 to cache SHSUCDX
SHCDX86.COM MSCDEX replacement (8086)
SHCDHD86.EXE Use an image file as a CD (8086)
SHCDRD86.EXE Use an image file in memory as a CD (286)
SHDVHD86.EXE Use image files as a DVD (8086)
SHCDRI86.EXE Create an image file in memory, use it as CD (286)
SHSUCDX.NSM NASM source code for SHSUCDX
SHSUCDHD.NSM NASM source code for SHSUCDHD
SHSUCDRD.NSM NASM source code for SHSUCDRD
SHSUDVHD.NSM NASM source code for SHSUDVHD
SHSUCDRI.NSM NASM source code for SHSUCDRI
NASM.MAC General purpose NASM macros
UNDOC.MAC Undocumented DOS and internal structures
CDROM.MAC CD-ROM structures
OMI.C (Borland) C source code for OMI
ISOBAR.C (Borland) C source code for ISOBAR
CDTEST.C (Borland) C source code for CDTEST
SMARTER.C (Borland) C source code for SMARTER
MAKEFILE (Borland) Makefile for the suite
ZLIBCDRD.LIB Library used by SHSUCDRD to decompress images
ZLIBCDRD.TXT Patches to zlib 1.2.1 to generate above
=======
Contact
=======
mailto:[email protected]
http://shsucdx.adoxa.vze.com/
==============================
Jason Hood, 2 September, 2022.