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.