Author: Matt Deatherage
Year: 1988
... describes the contents of the disks System.Disk and System.Tools and the minimum files necessary to boot GS/OS starting with System 5.0.
Apple II
Technical Notes
_____________________________________________________________________________
Developer Technical Support
GS/OS
#1: Contents of System.Disk and System.Tools
Revised by: Matt Deatherage January 1991
Written by: Matt Deatherage November 1988
This Technical Note describes the contents of the disks System.Disk and
System.Tools and the minimum files necessary to boot GS/OS starting with
System Software 5.0.
Changes since September 1990: Updated to reflect System Software version
5.0.4. Removed references to printer drivers which are not a part of 5.0.3 or
5.0.4. Removed version numbers for tools from this Note in favor of Apple IIgs
Technical Note #100, VersionVille.
_____________________________________________________________________________
This Note gives a description of each of the files in the Apple IIgs System
Software 5.0.4 package. This package includes three disks: System.Disk,
System.Tools, and the Apple II Setup disk for AppleShare 2.1.3 (Macintosh
format). System.Disk is bootable and includes two block drivers with 5.0.4.
System.Tools is not bootable, but with 5.0.4 it includes other drivers,
AppleTalk files, the Shaston 16 font and some utility programs. The Apple II
Setup disk is an update for AppleShare File Servers (version 2.01 or later)
which allows them to boot into GS/OS. Since the software on this disk is not
available for licensing and does not ship with applications, this Note does not
cover its contents.
Although System Software 5.0.4 may function in 512K (768K to use AppleShare or
the SCSI Manager), Apple has not tested it in systems with less than 1 Mb of
memory. Also note that many folder names on the 5.0.4 Golden Master disks are
incorrectly in all upper-case characters. This is only a cosmetic flaw; it does
not affect the installation or operation of the system software.
Because of the quantity of changes between System Software 5.0.2 and 5.0.4, the
changes to 5.0.4 are not detailed in this Note; however, files that changed
between 5.0.2 and 5.0.3 are marked with an asterisk (*). Files that changed
between 5.0.3 and 5.0.4 are marked with two asterisks (**).
Contents of System.Disk
ProDOS Every file system boots differently; the
boot blocks for ProDOS disks look for a
file name ProDOS. This is that file. It
is the GS/OS file system stub necessary to
start the boot process.
System The directory containing most of the GS/OS files.
CDevs The directory containing all Apple IIgs
Control Panel Devices (CDevs) required
for minimal operation.
Alphabet Sets translation specifications and
display languages.
DirectConnect Allows selection of direct-connected printers.
General Allows setting of general system parameters.
Keyboard Sets keyboard parameters.
Modem Controls modem port settings.
Monitor Sets 40-column or 80-column mode,
monochrome or color mode, and the color of
text, text background, and borders.
Mouse Sets mouse parameters.
Printer Controls printer port settings.
RAM Controls the size of the RAM disk and the
GS/OS Disk Cache.
Slots Allows selection of slot settings and
startup slot.
Sound Sets user preference for sound pitch and volume.
Time Sets the internal clock's time and display format.
CDev.Data A list of internal Control Panel
parameters for each CDev in the directory;
the list is precalculated for speed when
opening the Control Panel.
Desk.Accs The directory containing all the classic and new
desk accessory files to be loaded at boot time.
CtlPanel.NDA The new desk accessory which allows users
to control almost all system parameters
and choose printers and file servers.
Drivers The directory containing all device
drivers needed by GS/OS and the Toolbox
(including the Print Manager and MIDI Tools).
AppleDisk3.5 The Apple 3.5 Drive device driver for GS/OS.
AppleDisk5.25 The driver for Apple 5.25" disk drives,
including Disk II drives and Apple UniDisk
5.25 drives. This driver is required for
GS/OS to recognize 5.25" disk drives.
Console.Driver* The text screen and keyboard device driver
for GS/OS.
ImageWriter** The ImageWriter driver for the Print Manager.
Printer* The printer port driver for the Print Manager.
Modem* The modem port driver for the Print Manager.
Printer.Setup A file containing the default printer driver
and port driver settings for the Print Manager.
Error.Msg* A compiled file containing all error
messages required by GS/OS. This file is
separate from the GS.OS file to provide
easier support for localization.
ExpressLoad* New routines for GS/OS which load
specially processed files up to four times
faster than previously possible prior to
System Software 5.0. GS/OS loads
ExpressLoad at boot time on systems with
more than 512K total memory.
Fonts The directory containing all system fonts
to be used.
Courier.10 10-point Courier font.
Courier.12 12-point Courier font.
FastFont This makes Shaston 8 text drawing much
faster on systems with more than 512K of RAM.
Geneva.10 10-point Geneva font.
Geneva.12 12-point Geneva font.
Helvetica.10 10-point Helvetica font.
Helvetica.12 12-point Helvetica font.
Shaston.16 16-point Shaston font.
Times.10 10-point Times font.
Times.12 12-point Times font.
Venice.14 14-point Venice font.
Font.Lists A file prepared by the Font Manager when
FMStartUp is first called. It contains
information about all the fonts in the
Fonts directory and is only recalculated
if the Font Manager reasonably believes
the information has changed.
FSTs The directory containing the file system
translators to be loaded at boot time.
Char.FST* The character device FST.
Pro.FST* The ProDOS FST.
GS.OS* The remainder of GS/OS.
GS.OS.Dev* The GS/OS Device Manager and associated core
routines. Separate from GS.OS for speed reasons.
P8* The ProDOS 8 operating system.
Start The boot program. If this file exists,
GS/OS always launches it upon boot. In
this case, as in most cases, this is the
Finder.
Start.GS.OS* The file containing the GLoader and
GQuit routines. It loads the files GS.OS
and GS.OS.Dev, which contain the rest of
the operating system.
System.Setup The directory containing all the
initialization files to be executed at boot time.
CDev.Init A file, required for the Control Panel new
desk accessory, which executes any
initialization code in any CDev that is in
the CDev subdirectory.
Resource.Mgr* The Resource Manager. This is an
initialization file since the design of
the Resource Manager requires it to be
present even when an application has not
specifically loaded it. If this file is
not present, the system does not boot.
Sys.Resources A file containing system resources used by
the tools and the Control Panel, and which
are available to applications.
Tool.Setup A required file that loads files which
contain all the patches to tools in ROM
for ROM levels 01 (TS2) and 03 (TS3).
Tool.Setup would attempt to load TS1 if
executed on a machine with ROM level 00,
but GS/OS does not boot on such a machine,
therefore, TS1 is not included.
TS2* All the patches to ROM tools for ROM level 01.
TS3** All the patches to ROM tools for ROM level 03.
Tools The directory containing tool files for
all tools not in ROM.
Tool014* Window Manager.
Tool015* Menu Manager.
Tool016* Control Manager.
Tool018** QuickDraw Auxiliary.
Tool019 Print Manager.
Tool020* LineEdit.
Tool021* Dialog Manager.
Tool022 Scrap Manager.
Tool023* Standard File.
Tool025 Note Synthesizer.
Tool026 Note Sequencer.
Tool027* Font Manager.
Tool028* List Manager.
Tool034* TextEdit.
Finder.Def Finder default settings file. This file
must be present on the backup copy of
System.Disk used with the Installer. The
Installer cannot install GS/OS if this
file is not present on System.Disk.
Icons The directory containing all the Finder's
icon files.
Finder.Icons The core set of icons used by the
Finder for all system files and devices.
Finder.Icons.X The additional icons used by the Finder on
systems with more than 512K total total memory.
FType.Main* The file type names used by the Finder on
all systems.
FType.Aux* The additional file type names used by the Finder
on systems with more than 512K total memory.
AppleTalk A directory containing files to implement
the AppleTalk networking protocols. On
this disk, this folder is empty.
BASIC.System* The ProDOS 8 BASIC command interpreter.
BASIC.Launcher A short program which allows BASIC.System
to run AppleSoft program files which are
opened from the Finder.
Tutorial A directory containing several "empty"
files and other directories, used in user-
level documentation to teach the concepts
of a hierarchical file system. These
files are absolutely unnecessary to the
operation of the System Software.
Budgets
Finder.Data
Home
CY.1990
CY.1991
Finder.Data
Office
Finder.Data
FY.1990
FY.1991
Finder.Data
Graphics
Ad
Finder.Data
Flier
Letterhead
Masthead
Letters
Finder.Data
Mr.Merritt
Ms.Bachtold
To.Family
Dad
Finder.Data
Mom
TO.FRIENDS
Darryl
Finder.Data
Molly
Finder.Data* Information on window positions for the Finder.
Contents of System.Tools
Icons Additional icons for the Finder. This
folder is currently empty.
System A directory containing additional parts of
GS/OS not found on System.Disk.
CDevs Directory with additional Control Panel Devices.
AppleShare Allows users to choose and log onto
AppleShare file servers.
ATIWriter* Allows users to choose ImageWriter
printers on AppleTalk networks for use
with the Print Manager.
ATLQIWriter* Allows users to choose ImageWriter LQ
printers on AppleTalk networks for use
with the Print Manager.
ATLWriter* Allows users to choose LaserWriter
printers on AppleTalk networks for use
with the Print Manager.
DirectConnect Allows selection of direct-connected printers.
Desk.Accs Directory with additional desk accessories.
CDRemote An updated version of the CD Remote new
desk accessory which ships with the
AppleCD SC. This version works with the
SCSI Manager in System Software 5.0.
VideoMix.NDA* An updated version of the VideoMix new
desk accessory which ships with the Apple II
Video Overlay Card.
Drivers Directory with additional device drivers
for GS/OS and the Toolbox.
Apple.Midi The Apple MIDI Interface driver for the
MIDI Tools.
AppleDisk5.25 The driver for Apple 5.25" disk drives,
including Disk II drives and Apple UniDisk
5.25 drives. This driver is required for
GS/OS to recognize 5.25" disk drives.
AppleTalk The AppleTalk port driver for the Print
Manager. It works with either serial port
when configured for AppleTalk.
AT.IW.PSetup This file contains the same information as
the file Printer.Setup for an ImageWriter
printing through AppleTalk. The Installer
replaces the file Printer.Setup on the
destination disk with this file and
renames it Printer.Setup.
AT.IWLQ.PSetup This file contains the same information as
the file Printer.Setup for an ImageWriter
LQ printing through AppleTalk. The
Installer replaces the file Printer.Setup
on the destination disk with this file and
renames it Printer.Setup.
ATalk* The main AppleTalk GS/OS driver.
ATP1.ATROM AppleTalk protocols to patch the IIgs ROM.
ATP2.ATRAM* AppleTalk protocols not in ROM.
Card6850.MIDI The driver for 6850-based MIDI interface
cards for the MIDI Tools.
DeskJet.plus The Hewlett-Packard(R) DeskJet(TM) Plus driver
for the Print Manager.
Epson The Epson(R) printer driver for the Print Manager.
EPSON.PSetup This file contains the same information as
the file Printer.Setup for an Epson
printing through the parallel card driver.
The Installer replaces the file
Printer.Setup on the destination disk with
this file and renames it Printer.Setup.
ImageWriter** The ImageWriter driver for the Print Manager.
ImageWriter.LQ** The ImageWriter LQ driver for the Print
Manager. For 5.0.3, this driver is
completely new and uses all the
capabilities of the ImageWriter LQ.
IW.PSetup This file contains the same information as
the file Printer.Setup for an ImageWriter
printing through the printer port. The
Installer replaces the file Printer.Setup
on the destination disk with this file and
renames it Printer.Setup.
IWEM PostScript(R) program which allows a LaserWriter
emulate an ImageWriter. A user can load it into
the LaserWriter with the LaserWriter CDev, and
it is automatically invoked when printing
through the slot associated with AppleTalk.
IWLQ.PSetup This file contains the same information as
the file Printer.Setup for an ImageWriter
LQ printing through the printer port. The
Installer replaces the file Printer.Setup
on the destination disk with this file and
renames it Printer.Setup.
LaserWriter* The LaserWriter driver for the Print
Manager. This driver works with any
LaserWriter with PostScript. It does not
work with the LaserWriter IIsc.
LW.PSetup This file contains the same information as
the file Printer.Setup for an LaserWriter
printing through AppleTalk. The Installer
replaces the file Printer.Setup on the
destination disk with this file and
renames it Printer.Setup.
Modem* The modem port driver for the Print Manager.
Parallel.Card A driver for some parallel printer
interface cards for the Print Manager.
This driver works with the Apple Parallel
Interface Card, as well as several other
parallel interface cards.
Printer* The printer port driver for the Print Manager.
SCC.Manager The GS/OS supervisory driver that
arbitrates hardware-level usage of the SCC
in the Apple IIgs.
SCSI.Manager** The GS/OS SCSI Manager, the supervisory
driver that arbitrates hardware-level
usage of Apple II SCSI cards.
SCSICD.Driver* The GS/OS driver for the AppleCD SC drive.
This driver is required for GS/OS to
recognize CD-ROM drives.
SCSIHD.Driver* The GS/OS driver for SCSI hard disks.
This driver is required for GS/OS to
recognize SCSI hard disks.
UniDisk3.5* The GS/OS driver for UniDisk 3.5 drives.
This driver is required for proper
operation of UniDisk 3.5 drives. Using
the UniDisk with GS/OS without this driver
eventually corrupts media.
FSTs Directory with additional File System Translators.
AppleShare.FST** The AppleShare FST which allows GS/OS to
access AppleShare file servers.
HS.FST The High Sierra FST which allows GS/OS to
access CD-ROM discs formatted in the
international standard High Sierra or ISO
9660 formats. This FST is read-only; it
only performs read operations.
System.Setup Directory with additional
initialization files.
AppleIIVOC.INIT An initialization file used by the Apple IIgs
Video Overlay Card tool set.
ATInit The AppleTalk initialization file.
ATResponder The AppleTalk Responder, used for
AppleTalk network management.
Tools Directory with additional tools.
Tool029* ACE Tools.
Tool032 MIDI Tools.
Tool033 Video Overlay Card tool set.
Fonts Directory with additional fonts.
Shaston.16* 16-point Shaston font.
Times.12* 12-point Times font.
Scripts This directory contains all the scripts
for the Installer. On launch, the Installer
looks in its parent directory for the Scripts
directory and the scripts it contains.
ACE* Script to install the Audio Compression
and Expansion tools.
ADV.DISK.UTIL Script to install the Advanced Disk
Utility program.
APPLE.MIDI Script to install the Apple MIDI Interface
driver and tool set.
APPLEDISK5.25 Script to install the 5.25" disk driver for GS/OS.
APPLESHARE Script to install AppleShare.
Aristotle.Patch Script to install a change to Aristotle
for easier class transition.
ATIMAGEWRITER Script to install the ImageWriter printer
driver for the Print Manager, as well as
the files necessary to work with AppleTalk.
ATIMAGEWRITERLQ Script to install the ImageWriter LQ
printer driver for the Print Manager, as well
as the files necessary to work with AppleTalk.
CARD6850.MIDI Script to install the 6850-based MIDI
Interface card driver.
CDROM Script to install the High Sierra FST as well as
the SCSI Manager and SCSI CD-ROM driver for GS/OS.
DCIMAGEWRITER Script to install the ImageWriter printer
driver for the Print Manager, as well as the
files necessary to connect it to a serial port.
DCIMAGEWRITERLQ Script to install the ImageWriter LQ printer
driver for the Print Manager, as well as the
files necessary to connect it to a serial port.
EPSON Script to install the Epson printer driver for
the Print Manager, as well as the parallel card
driver.
FONTS* Script to install additional fonts.
HP.DeskJet Script to install the Hewlett-Packard
DeskJet Plus printer driver for the Print
Manager, as well as the files necessary to
connect it to a serial port.
INST.SYS.MIN Script to install a minimal GS/OS system with
AppleShare on a given destination volume. This
script appears as "AppleShare on 3.5 Disk" in the
Installer's list of updates.
INST.SYSF.NOFIN* Script to install a minimal GS/OS system, without
the Finder, on a given destination volume.
INSTAL.SYS.FILE* Script to install a GS/OS system, with the
Finder, on a given destination volume.
LASERWRITER Script to install the LaserWriter printer driver
for the Print Manager, as well as the files
necessary to work with AppleTalk.
Local.Net.Boot* Script to create a 3.5" floppy disk with
the minimum configuration necessary to boot
locally but log onto an AppleShare file server.
NAMER Script to install Namer II and related
AppleTalk files.
Quick.Logoff Script to add a quick logoff feature
to AppleShare.
SCSI.HARD.DISK* Script to install the SCSI Manager and
SCSI hard disk driver for GS/OS.
Server.Sys.File* Script to install System Software 5.0 on
an AppleShare File Server.
UNIDISK3.5 Script to install the UniDisk 3.5 driver
for GS/OS.
VIDEOMIX Script to install the latest versions of
the Apple II VideoMix software and tools.
Installer* The Apple IIgs Installer program. This program
makes use of scripts found in the Scripts
directory on this disk to install parts of the
system, as well as third-party applications,
without the user needing to copy individual
files.
AppleTalk This directory contains additional
AppleTalk files and utilities for
AppleShare and AppleTalk.
Boot.Driver A driver for AppleShare that GS/OS loads
before the other drivers are loaded and
which remains resident in memory after the
boot process is finished. Installed on
servers by the Installer script Server.Sys.File.
Display.0
Namer This directory contains the Namer II application
to rename AppleTalk devices.
MtxAbs.0 MouseText code routines for by Namer II.
Namer.II The Namer II application (a ProDOS 8 program).
Namer.0 Additional code needed by Namer II.
QuickLogoff An initialization file used to add a quick
logoff feature to AppleShare.
Start The AppleShare startup program which is
installed in place of the Finder on
AppleShare volumes. It allows the user to
log on and then launches the server
startup program for the user's machine.
Adv.Disk.Util The Advanced Disk Utility program which
allows for partitioning of SCSI hard
disks, as well as erasing, initializing,
and zeroing volumes or partitions.
Minimum GS/OS System Disk Requirements
The following files are required for GS/OS to boot. This list does not
address files needed by the Finder or the IIgs Toolbox. Those files only
required in certain circumstances are noted as such. Those files that may be
excluded only when disk space or memory limitations make it absolutely
necessary are marked with asterisks (*).
ProDOS
System
Start.GS.OS
GS.OS
GS.OS.Dev
Error.Msg
FSTs
Pro.FST Required for ProDOS disks.
HS.FST Required for High Sierra or ISO 9660 discs.
Char.FST
AppleShare.FST Required to use AppleShare file servers
Drivers
AppleDisk3.5 Required for Apple 3.5 Drives.
AppleDisk5.25 Required for 5.25" drives.
UniDisk3.5 Required for UniDisk 3.5 drives.
SCSI.Manager Required for SCSI devices.
SCSIHD.Driver Required for SCSI hard disks.
SCSICD.Driver Required for AppleCD SC drives.
Console.Driver
ATalk Required for AppleTalk (including AppleShare).
ATP1.ATROM Required for AppleTalk (including AppleShare).
ATP2.ATRAM Required for AppleTalk (including AppleShare).
SCC.Manager Required for AppleTalk (including AppleShare).
System.Setup
CDev.INIT Required for the Control Panel NDA.
Tool.Setup
TS2
TS3
Resource.Mgr
Sys.Resources
CDevs
Alphabet*
AppleShare* Required for selecting AppleShare file servers.
ATIWriter* Required for choosing printers.
ATLQIWriter* Required for choosing printers.
ATLWriter* Required for choosing printers.
DirectConnect* Required for choosing printers.
General*
Keyboard*
Modem*
Monitor*
Mouse*
Printer*
RAM* Should always be included if space allows.
Provides the only way to set the size of the
GS/OS Disk Cache.
Slots*
Sound*
Time*
CDev.Data* Only required if using the same CDevs that
ship on System.Disk.
Desk.Accs* Required for desk accessories; any desk
accessories should be installed in this directory.
CtlPanel.NDA*
ExpressLoad* The only reason not to ship ExpressLoad is a
lack of disk space; it is not loaded in
512K systems.
Start Must be present for GS/OS to boot or some
other file that GS/OS can boot into must
be present in its place.
Tools Required for any of the RAM-based tools;
any RAM-based tools should be installed in
this directory.
Fonts Required for the Font Manager.
FastFont* This makes Shaston 8 text drawing much faster
and should be included unless
absolutely impossible.
P8 Required for ProDOS 8.
BASIC.System Required for AppleSoft BASIC.
BASIC.Launcher Required for AppleSoft BASIC if the user is
allowed to open these programs from the Finder.
Further Reference
_____________________________________________________________________________
o GS/OS Reference
Epson is a registered trademark of Seiko Epson Corporation.
PostScript is a registered trademark of Adobe Systems, Incorporated.