| 1 |
<HTML> |
| 2 |
<HEAD> |
| 3 |
<TITLE>Setting up SheepShaver</TITLE> |
| 4 |
</HEAD> |
| 5 |
<BODY BGCOLOR=#FFFFFF> |
| 6 |
|
| 7 |
<H1>Setting up SheepShaver</H1> |
| 8 |
|
| 9 |
In the "SheepShaver Settings" window that pops up when you start SheepShaver, |
| 10 |
you can configure certain features of SheepShaver. When you click on <B>"Start"</B>, |
| 11 |
the current settings are saved to disk and will be available next time you start |
| 12 |
SheepShaver. |
| 13 |
|
| 14 |
<P>The settings are divided into four groups: Volumes, Graphics/Sound, Serial/Network and Memory/Misc. |
| 15 |
|
| 16 |
<H2>Volumes</H2> |
| 17 |
|
| 18 |
<IMG SRC="volumes.gif"> |
| 19 |
|
| 20 |
<P>The main part of the volumes pane is a <B>list</B> that contains all volumes to be mounted |
| 21 |
by SheepShaver. If this list is empty, SheepShaver will try to detect and mount all |
| 22 |
HFS partitions it can find. A CD-ROM drive is always automatically detected and used. |
| 23 |
|
| 24 |
<P>SheepShaver can use HFS partitions, whole HFS formatted drives, and it can also |
| 25 |
emulate hard disks in single Linux files ("hardfiles"). |
| 26 |
|
| 27 |
<P>To add a Mac volume to the list, click on <B>"Add..."</B>, go to the "/dev" directory |
| 28 |
in the file panel, click once on the partition you want and click on "OK". The selected |
| 29 |
partition device name should then appear in the volume list. After adding volumes to |
| 30 |
the list, you should unmount them on the Linux side. To remove a Mac volume, select it |
| 31 |
in the list and click on <B>"Remove"</B>. |
| 32 |
|
| 33 |
<P>You can create a new, empty hardfile by clicking on <B>"Create..."</B>. Enter the file |
| 34 |
name and the size of the hardfile and click on "Create". The hardfile will be created (this may |
| 35 |
take some seconds) and added to the volume list. The so-created hardfile will have to be |
| 36 |
formatted under MacOS before you can store something in it. If you start up SheepShaver, |
| 37 |
the Finder will display a message about an "unreadable" volume being found and give you the |
| 38 |
option to format it. |
| 39 |
|
| 40 |
<P>Double-clicking on an entry in the volume list will add or remove a "*" in front of the |
| 41 |
device name. Volumes marked with a "*" are read-only for the MacOS under SheepShaver. |
| 42 |
|
| 43 |
<P>SheepShaver will show a "Linux" disk icon on the Mac desktop that allows access to Linux |
| 44 |
files from Mac applications. In <B>"Linux Root"</B> you specify which Linux directory will |
| 45 |
be at the root of this virtual "Linux" disk. The default setting of "/" means that the |
| 46 |
"Linux" icon in the MacOS Finder will correspond to your Linux root directory. The MacOS |
| 47 |
will try to create files and folders like "Desktop", "Trash", "OpenFolderListDF" etc. |
| 48 |
in the directory you specify as "Linux Root" (provided that you have access rights |
| 49 |
to that directory). If they annoy you, you can delete them. |
| 50 |
|
| 51 |
<P>To boot from CD-ROM, set the <B>"Boot From"</B> setting to <B>"CD-ROM"</B>. |
| 52 |
The <B>"Disable CD-ROM Driver"</B> box is used to disable SheepShaver's built-in CD-ROM driver. |
| 53 |
This is currently of not much use and you should leave the box unselected. |
| 54 |
|
| 55 |
<H2>Graphics/Sound</H2> |
| 56 |
|
| 57 |
<IMG SRC="graphics.gif"> |
| 58 |
|
| 59 |
<P>With <B>"Window Refresh Rate"</B> you can set the refresh rate of the MacOS window. |
| 60 |
Higher rates mean faster screen updates and less "sluggish" behaviour, but also require more CPU time. |
| 61 |
|
| 62 |
<P>The <B>"Enabled Video Modes"</B> controls allow you to select which graphics modes |
| 63 |
are available for displaying the MacOS desktop. You can, for example, disable the window modes |
| 64 |
when you want to run some Mac programs in full-screen mode that would otherwise erroneously |
| 65 |
switch to a window mode. If your X server doesn't support DGA you should disable the Fullscreen |
| 66 |
mode. The actual mode to be used is selected in the "Monitors" control panel under MacOS. The |
| 67 |
color depth is always that of the X11 screen and cannot be changed. |
| 68 |
|
| 69 |
<P>The <B>"Disable Sound Output"</B> box allows you to disable all sound output by SheepShaver. |
| 70 |
This is useful if the sound takes too much CPU time on your machine or to get rid of warning |
| 71 |
messages if SheepShaver can't use your audio hardware. |
| 72 |
|
| 73 |
<H2>Serial/Network</H2> |
| 74 |
|
| 75 |
<IMG SRC="serial.gif"> |
| 76 |
|
| 77 |
<P>You can select to which devices the MacOS <B>modem and printer ports</B> are redirected. |
| 78 |
You can assign them to any serial ports you have (/dev/ttyS*), or even to parallel |
| 79 |
ports (/dev/lp*, useful for printing if you have Mac drivers for parallel printers, |
| 80 |
like the PowerPrint package from <A HREF="http://www.gdt.com">www.gdt.com</A>). |
| 81 |
|
| 82 |
<P>With <B>"Ethernet Interface"</B> you select which Ethernet card is to be used for |
| 83 |
networking. It can either be the name of a real Ethernet card (e.g. "eth0") or of an ethertap |
| 84 |
interface (e.g. "tap0"). Using a real Ethernet card requires the "sheep_net" driver to be installed |
| 85 |
and accessible. See <A HREF="using.html">Using SheepShaver</A> for more |
| 86 |
information about setting up networking. |
| 87 |
|
| 88 |
<H2>Memory/Misc</H2> |
| 89 |
|
| 90 |
<IMG SRC="memory.gif"> |
| 91 |
|
| 92 |
<P>With <B>"MacOS RAM Size"</B> you select how much RAM will be available to the MacOS |
| 93 |
(and all MacOS applications running under it). SheepShaver uses the Linux virtual memory system, |
| 94 |
so you can select more RAM than you physically have in your machine. The MacOS virtual memory |
| 95 |
system is not available under SheepShaver (i.e. if you have 32MB of RAM in your computer and |
| 96 |
select 64MB to be used for MacOS in the SheepShaver settings, MacOS will behave as if it's running on |
| 97 |
a computer that has 64MB of RAM but no virtual memory). |
| 98 |
|
| 99 |
<P><B>"ROM File"</B> specifies the path name of the Mac ROM file to be used. If it is left |
| 100 |
blank, SheepShaver expects the ROM file to be called "ROM" and be in the same directory as |
| 101 |
the SheepShaver application. |
| 102 |
|
| 103 |
<P>The <B>"Ignore Illegal Memory Accesses"</B> option is there to make some broken Mac |
| 104 |
programs work that access addresses where there is no RAM or ROM. With this option unchecked, |
| 105 |
SheepShaver will in this case display an error message and quit. When the option is activated, |
| 106 |
SheepShaver will try to continue as if the illegal access never happened (writes are ignored, reads |
| 107 |
return 0). This may or may not make the program work (when a program performs an illegal access, |
| 108 |
it is most likely that something else went wrong). When a Mac program behaves strangely or hangs, |
| 109 |
you can quit SheepShaver, uncheck this option and retry. If you get an "illegal access" message, |
| 110 |
you will know that something is broken. |
| 111 |
|
| 112 |
<HR> |
| 113 |
<ADDRESS> |
| 114 |
SheepShaver User's Guide |
| 115 |
</ADDRESS> |
| 116 |
</BODY> |
| 117 |
</HTML> |
