startmac(1) startmac(1)NAME startmac, startmac24 - create a Macintosh environment SYNOPSIS startmac [-s sysfolder] [-f findername] [-o option[=value]] [-m memsize] [-P patchfile] [-S systemfile] startmac24 [-u user] [-s sysfolder] [-f findername] [-o option[=value]] [-m memsize] [-P patchfile] [-S systemfile] StartupApplication DESCRIPTION startmac is used to create and initialize the Macintosh en-rvironment under A/UX . Various options and environment vari-ables can be used to change the default actions. startmac24 is similar to startmac except that it creates a 24-bit-only environment, thus allowing applications that are not 32-bit clean to run. startmac will rarely be invoked directly by the user. It may be useful in those cases where the user wishes to have a console emulator login environment and still be able to run Macintosh applications and tools. Even then, the user will probably prefer to invoke mac32 or mac24, which will in turn invoke startmac or startmac24. Wherever startmac is referenced below, startmac24 may be substituted. FLAG OPTIONS startmac and startmac24 accept the following options. Where environment variables may be used to set defaults, those en- vironment variables will be overridden by the appropriate command line option. -u user Specifies an alternate system folder. The pre- ferred system folder will be taken from the indicated user's home directory, instead of invoking the user. -s sysfolder Specifies an alternate system folder. The sys- tem folder will be the specified directory. -f findername Specifies an alternate application to take theTMplace of the Finder . The name of the appli-cation is findername instead of Finder. The Finder or the application to run in place of the Finder is always found in the system fold- er. Multifinder will automatically launch the Finder whenever no other applications exist and at initial startup. April, 1990 1
startmac(1) startmac(1)-o option Specify one of the debugging options indicated below. option is a string of the form option[=value]. In each case, value should be either 0 or 1, although any nonzero value turns the feature on. warn Warning messages are printed to the invoking terminal. This is best used from a serial port or other noncon- sole terminal. traps Each trap invocation generates a warning. The warning is not actually printed unless warn is also set. verbose More warnings than you could possi- bly want to see are generated. Once again, warn must be set for them to actually be printed. ram Copy the ROM into RAM. This can be used to facilitate debugging as breakpoints are easier to set. -m memsize Sets the size of the virtual Macintosh the en- vironment will be run in. memsize is a scaled value of the form number scale. scale is al- lowed to be m, M number is in megabytes k, K number is in kilobytes -P patchfile Sets the name of the patch file to be used. Normally, the appropriate patch file name will be constructed by concatenating the string ``Patch.'' and the hexadecimal ROM version number. Currently, the valid patch files are Patch.0178 (for Macintosh II, Macintosh IIx, and Macintosh SE/30 computers) and Patch.067C (for Macintosh IIci and Macintosh IIfx comput- ers). The patch file is always found in the system folder. -S systemfile Sets the name of the system file to be used. Normally, this is ``System.'' The system file is always found in the system folder. ENVIRONMENT The following environment variables may be used to affect the defaults of startmac. They are especially useful in that if they are set in the user's .login or .profile ini- 2 April, 1990
startmac(1) startmac(1)tialization script, they will affect the Macintosh environ- ment created when the user logs in to a Macintosh environ- ment. If both an environment variable and the appropriate command line option are specified, the command line option always takes precedence. TBRAM Same as -o ram debug option. Copies the ROM into RAM to facilitate debugging. TBTRAP Same as -o trap debug option. Prints a message for each trap invocation. TBWARN Same as -o warn debug option. Causes warning messages to be printed. TBSYSTEM Same as -s option. Changes the default system folder to be used. TBPATCHES Same as -P option. Changes the default patch file to be used. TBMEMORY Same as -m option. Changes the virtual memory size to be used. SYSTEM FOLDER Many files important to the Macintosh environment are found within the system folder. It is, therefore, important to know where startmac finds the system folder. startmac fol- lows the following logic looking for a system folder: 1. If the -s option is specified, looks in the specified directory. 2. Checks for a directory named ``System Folder'' located in the user's home directory. The user's home directory is normally in the environment variable HOME, unless the -u option is specified, in which case it will be that user's home directory. If neither is set, the home directory will be the current user's home directory. 3. For startmac24 only, checks the directory named ``Sys- tem Folder24'' located in the user's home directory. 4. Checks the /mac/sys/SystemFolder. FILES /mac/bin/startmac /mac/bin/startmac24 {systemfolder}/Patch.{RomID} {systemfolder}/Finder {systemfolder}/MultiFinder {systemfolder}/System April, 1990 3
startmac(1) startmac(1)SEE ALSO mac32(1), mac24(1). BUGS Only the most common and useful options are documented here. 4 April, 1990