[[http://www.gibix.net/dokuwiki/en:projects:sheepshaver:help| Help Centre]] [[http://www.gibix.net/dokuwiki/en:projects:sheepshaver:help:installation| Installing SheepShaver]] [[http://www.gibix.net/dokuwiki/en:projects:sheepshaver:help:setup| Setting up SheepShaver]] [[http://www.gibix.net/dokuwiki/en:projects:sheepshaver:help:networking| Networking]] [[http://www.gibix.net/dokuwiki/en:projects:sheepshaver:help:using_sheepshaver| Using SheepShaver]] [[http://www.gibix.net/dokuwiki/en:projects:sheepshaver:help:configuration_file| The configuration file]] ====== Setting up SheepShaver ====== ===== Linux ===== When you start SheepShaver a "SheepShaver Settings" window pops up. You can configure certain features of SheepShaver from it. The current settings are saved to disk in a file called ".sheepshaver_prefs" in your home directory. The settings are divided into six groups: * Volumes * Graphics/Sound * Mouse/Keyboard * Serial/Network * Memory/Misc * JIT Compiler ==== Volumes ==== {{en:projects:sheepshaver:help:sheepshaversettings_1_volumes.jpg}} \\ Figure 1: The Volumes Window \\ The main part of the volumes pane is a list that contains all volumes to be mounted by SheepShaver. If this list is empty, SheepShaver will try to detect and mount all HFS partitions it can find. A CD-ROM drive is always automatically detected and used. For Mac Volumes, SheepShaver can use Mac HFS partitions, whole Mac HFS formatted drives, and can also emulate hard disks in single Linux files ("hardfiles"). * Mac HFS partition: a part of your hard disk formatted for HFS \\ * Mac HFS volume: a hard disk formatted for HFS \\ * Hard file: a file on your linux partition to be used as Mac hard disk \\ To add a Mac HFS volume or partition to the list, click on "Add...", go to the "/dev" directory in the file panel, click once on the partition you want and click on "OK". The selected partition device name should then appear in the volume list. After adding volumes or partitions to the list, you should unmount them on the Linux side. To remove a Mac volume, select it in the list and click on "Remove". SheepShaver will show a "Linux" disk icon on the Mac desktop that allows access to Linux files from Mac applications. In "Linux Root" you specify which Linux directory will be at the root of this virtual "Linux" disk. The default setting of "/" means that the "Linux" icon in the MacOS Finder will correspond to your Linux root directory. The MacOS will try to create files and folders like "Desktop", "Trash", "OpenFolderListDF" etc. in the directory you specify as "Linux Root" (provided that you have access rights to that directory). If they annoy you, you can delete them. To boot from CD-ROM, set the "Boot From" setting to "CD-ROM". The "Disable CD-ROM Driver" box is used to disable SheepShaver's built-in CD-ROM driver. This is currently of not much use and you should leave the box unselected. Double-clicking on an entry in the volume list will add or remove a "*" in front of the device name. Volumes marked with a "*" are read-only for the MacOS under SheepShaver. {{en:projects:sheepshaver:help:sheepshaversettings_1_2_volumes_add.jpg}} \\ Figure 2: Adding a volume to SheepShaver \\ You can create a new, empty hardfile by clicking "Create...". Enter the file name and the size of the hardfile (see figure 3) and click "OK". The hardfile will be created (this may take some seconds) and added to the volume list. The so-created hardfile will have to be formatted under MacOS before you can store anything in it. When you start up SheepShaver, the Finder will display a message about an "unreadable" volume being found and give you the option to format it. You will have to install Mac OS on the volume, so be shure it contains enough space {{en:projects:sheepshaver:help:sheepshaversettings_1_1_volumes_create.jpg}} \\ Figure 3:creating a hard file \\ ==== Graphics/Sound ==== {{en:projects:sheepshaver:help:sheepshaversettings_2_graphics_sound.jpg}} \\ Figure 4: Setting Screen and Sound preferences \\ You can use the follow settings to control screen size, quickdraw accelleration and sound output: \\ * Video Type: Video Type can be "Window" or "Full Screen" * Window Refresh Rate: select the refresh rate from the dropdown list. A faster refresh rate, however, slows SheepShaver down * Width: The width of the screen to use. Select from the dropdown list. "Maximum" uses current screen settings * Height: The height of the screen to use. Select from the dropdown list. "Maximum" uses current screen settings * Quickdraw Acceleration: SheepShaver can accelerate certain quickdraw functions. Select to use the acceleration. * Disable Sound Output: Select to disable sound output if sound takes too much processing power. \\ * Audio Output Device: Choose a different output device if the preselected one is not to your liking * Audio Mixer Device: Choose a different mixer device if the preselected one is not to your liking \\ **Please note**: the actual screen size can be choosen from within Mac OS, through the "Monitors" control panel ==== Mouse/Keyboard ==== {{en:projects:sheepshaver:help:sheepshaversettings_3_mouse_keyboard.jpg}} \\ Figure 5: The Mouse and Keyboard settings \\ To define the keyboard layout and mouse behaviour, the follow settings are available: * Use Raw Keycodes: When selected, the selection box below comes available to select a raw keycode file, that will be used to map your keyboard. * Mouse Wheel Function: The mouse wheel function can be "Cursor Up/Down" or "Page Up/Down". Page Up/down means one mouse wheel knotch will move the visible area of the screen one page up or down. Cursor Up/down is used in combination with "Lines to scroll" * Lines to scroll: Sets the number of lines the cursor is moved up or down on one mouse wheel knotch. ==== Serial/Network ==== {{en:projects:sheepshaver:help:sheepshaversettings_4_serial_network.jpg}} \\ Figure 6: Selecting port and ethernet interfaces \\ You can select to which devices the MacOS modem and printer ports are redirected. You can assign them to any serial ports you have (/dev/ttyS*), or even to parallel ports (/dev/lp*, useful for printing if you have Mac drivers for parallel printers, like the PowerPrint package from gdt. With "Ethernet Interface" you select which Ethernet card is to be used for networking. It can either be: * eth0 (the name of a real Ethernet card or * tap0 (the name of an Ethertap interface or * slirp (using an internal DHCP server)\\ Using a real Ethernet card requires the "sheep_net" driver to be installed and accessible. See [[http://www.gibix.net/dokuwiki/en:projects:sheepshaver:help:networking|Networking]] for more information about setting up the network. \\ ==== Memory/Misc ==== {{en:projects:sheepshaver:help:sheepshaversettings_5_memory_misc.jpg}} \\ Figure 7: Choosing the memory available to SheepShaver and pointing to the ROM file \\ With "MacOS RAM Size" you select how much RAM will be available to the MacOS (and all MacOS applications running under it). SheepShaver uses the Linux virtual memory system, so you can select more RAM than you physically have in your machine. The MacOS virtual memory system is not available under SheepShaver (i.e. if you have 32MB of RAM in your computer and select 64MB to be used for MacOS in the SheepShaver settings, MacOS will behave as if it's running on a computer that has 64MB of RAM but no virtual memory). "ROM File" specifies the path name of the Mac ROM file to be used. If it is left blank, SheepShaver expects the ROM file to be called "ROM" and for it to be in the same directory as the SheepShaver application. The "Ignore Illegal Memory Accesses" option is there to make some broken Mac programs work that access addresses where there is no RAM or ROM. With this option unchecked, SheepShaver will in this case display an error message and quit. When the option is activated, SheepShaver will try to continue as if the illegal access never happened (writes are ignored, reads return 0). This may or may not make the program work (when a program performs an illegal access, it is most likely that something else went wrong). When a Mac program behaves strangely or hangs, you can quit SheepShaver, uncheck this option and retry. If you get an "illegal access" message, you will know that something is broken. ==== JIT-Compiler ==== {{en:projects:sheepshaver:help:sheepshaversettings_6_jit_compiler.jpg}} \\ Figure 8: Enabling the JIT (Just In Time) compiler \\ The "Enable JIT Compiler" is best kept checked for performance reasons. ===== Windows ===== You can start SheepShaver through the SheepShaver GUI contained in your download. The “SheepShaver Settings” window pops up. You can configure certain features of SheepShaver from it. The current settings are saved to disk in a file called “.sheepshaver_prefs” in the SheepShaver directory. \\ The settings are divided into seven groups: * Volumes * Graphics/Sound * Mouse/Keyboard * Serial * Network * Memory/Misc * JIT Compiler ==== Volumes ==== {{en:projects:sheepshaver:help:sheepshaversettings_volumes_1_1_windows.jpg}} \\ Figure 1: The Volumes Window \\ The main part of the volumes pane is a list that contains all volumes to be mounted by SheepShaver. A CD-ROM drive is always automatically detected and used. For Mac Volumes, SheepShaver can use emulated hard disks in single Windows files ("hardfiles"). * Add: To add an already existing hard file to be used as hard disk by Mac OS. (see screenshot below) \\ * Create: To create a new hard file to be used as hard disk by Mac OS. (see screenshot below) \\ * Remove: To remove an earlier added hard file from the list of hard disks to be used by Mac OS \\ * Boot From: You can choose between "any" or "cdrom" \\ "Any" means SheepShaver will start Mac OS from any hard file or cdrom it can find a bootable Mac partition on. Choosing "cdrom" will always try to boot from CD \\ * CD-Rom Drive: Which cdrom drive(s) to use, in case you have more. Select one from the dropdown list\\ * Try to automatically detect new removable media (enable polling): SheepShaver will periodically check for new media (cdrom, floppy)\\ * Enable "My Computer"icon on your Mac desktop (external file system): Gives access to Windows drives \\ * Mount drives: Defines which drives will be accessable through the My Computer icon on the Mac OS desktop " \\ FIXME: ScreenShots below show Dutch text. I don't know how to change GTK language settings yet. (my Windows version is English though....) \\ {{en:projects:sheepshaver:help:sheepshaversettings_volumes_add_1_2_windows.jpg}} \\ Figure 2: Adding a existing volume to the volume list \\ {{en:projects:sheepshaver:help:sheepshaversettings_volumes_create_1_3_windows.jpg}} \\ Figure 3: Creating a new hard file to be used as hard disk in Mac OS ==== Graphics/Sound ==== {{en:projects:sheepshaver:help:sheepshaversettings_graphics_sound_2_windows.jpg}} \\ Figure 4: The Graphics and Sound settings window \\ You can use the follow settings to control screen size, quickdraw accelleration and sound output: \\ * Video Type: Video Type can be "Window" or "Full Screen" * Window Refresh Rate: select the refresh rate from the dropdown list. A faster refresh rate, however, slows SheepShaver down * Width: The width of the screen to use. Select from the dropdown list. "Maximum" uses current Windows screen settings * Height: The height of the screen to use. Select from the dropdown list. "Maximum" uses current Windows screen settings * Quickdraw Acceleration: SheepShaver can accelerate certain quickdraw functions. Select to use the acceleration. * Disable Sound Output: Select to disable sound output. \\ **Please note**: the actual screen size can be choosen from within Mac OS, through the "Monitors" control panel ==== Mouse/Keyboard ==== {{en:projects:sheepshaver:help:sheepshaversettings_keyboard_mouse_3_windows.jpg}} \\ Figure 5: The keyboard and mouse options \\ To define the keyboard layout and mouse behaviour, the follow settings are available: * Use Raw Keycodes: When selected, the selection box below comes available to select a raw keycode file, that will be used to map your keyboard. * Mouse Wheel Function: The mouse wheel function can be "Cursor Up/Down" or "Page Up/Down". Page Up/down means one mouse wheel knotch will move the visible area of the screen one page up or down. Cursor Up/down is used in combination with "Lines to scroll" * Lines to scroll: Sets the number of lines the cursor is moved up or down on one mouse wheel knotch. ==== Serial ==== {{en:projects:sheepshaver:help:sheepshaversettings_serial_4_windows.jpg}} \\ Figure 6: The Serial ports settings \\ You can select to which devices the MacOS modem and printer ports are redirected. You can assign them to any serial ports you have, or even to parallel ports, useful for printing if you have Mac drivers for parallel printers, like the PowerPrint package from gdt. * Modem Port: Select any of the available com or ltp ports. Select file if you want to redirect output to a file. * File: This option comes available when "file" is choosen above. Set the name and location of the file here \\ * Printer Port: Select any of the available com or ltp ports. Select file if you want to redirect output to a file. * File: This option comes available when "file" is choosen above. Set the name and location of the file here \\ ==== Network ==== {{en:projects:sheepshaver:help:sheepshaversettings_network_5_windows.jpg}} \\ Figure 7: The Network settings \\ * Ethernet Interface: select the ethernet interface to be used for networking. FIXME: add description of items below. * FTP ports: * Server ports: **Please note:** you need to perform the BasiliskII ethernet driver installation described [[http://www.gibix.net/dokuwiki/en:projects:sheepshaver:help:networking#windows|here]] before you can select an ethernet interface. ==== Memory/Misc ==== {{en:projects:sheepshaver:help:sheepshaversettings_memory_misc_6_windows.jpg}} \\ Figure 8: Setting memory, rom and other options \\ You have to set the amount of memory available for Mac OS and which rom image file to use. * MacOS RAM Size (MB): the amount of memory for Mac OS. Select an option from the dropdown list. * ROM File: The rom file to use. You can browse to the location of your rom file. * Ignore Illegal Memory Accesses: When selected, SheepShaver relaxes control for applications referring to non-existing memory locations. * Don't use CPU when Idle: Lets SheepShaver throttle cpu use when no activity is needed. ==== JIT-Compiler ==== {{en:projects:sheepshaver:help:sheepshaversettings_jit_compiler_7_windows.jpg}} \\ Figure 9: Setting JIT en 68K DR Emulator \\ FIXME: better descriptions of the options below are needed. The Just In Time Compiler SheepShaver uses can be enabled or disabled, as can the experimental 68K DR emulator. * Enable JIT Compiler: select to enable the JIT-Compiler. This improves emulation speed. * Enable built-in 68K DR Emulator: ===== MacOS X PPC & Intel===== A GUI is available for SheepShaver on Mac OSX in the download. // For information on how to use it, please refer to the linux section above. // Just take care _not_ to share your root folder or home folder through "extfs". Create a separate folder for sharing with the host.