
Erste Hilfe bei Schwierigkeiten mit WarpOS
------------------------------------------

- Problem:
  Die powerpc.library kann nicht geoeffnet werden. Die WarpUp-Demos
  funktionieren gar nicht und geben eventuell Fehlermeldungen der
  Art aus 'Kann powerpc.library nicht oeffnen'.

- Loesung:
  Die powerpc.library V8 oder groesser kann nur dann geoeffnet
  werden, wenn die ppc.library von Phase 5 nicht laeuft. Das
  heisst, wenn man WarpOS benutzen will, muss man dafuer sorgen,
  dass keine PowerPC-Programme laufen, welche die ppc.library
  benoetigen.

  Es ist dabei zu beachten, dass selbst Programme, welche dezent
  im Hintergrund laufen, die ppc.library benuetzen koennen. Unter
  anderem gibt es Versionen der Grafikkarten-Software 'CyberGraphX'
  welche die ppc.library benuetzen. In diesem Falle muss eine
  CyberGraphX-Version ohne ppc.library-Unterstuetzung installiert
  werden, wenn WarpOS verwendet werden soll.



- Problem:
  Die powerpc.library kann nicht geoeffnet werden, obwohl nie eine
  Applikation gestartet wurde, welche die ppc.library oeffnet.

- Loesung:
  In diesem Falle kann es sein, dass die ppc.library schon beim
  Booten geoeffnet wurde, sie liegt dann in einem nichtfluechtigen
  Speicher.

  Die beste Loesung waere, ein Upgrade des nichtfluechtigen Speichers
  zu machen, welches die ppc.library nicht mehr beim Booten oeffnet.
  Die Funktionstuechtigkeit der Hardware und Software koennte
  problemlos gewaehrleistet werden. Nur dann kann sich WarpOS auch
  voellig systemkonform ins System einbinden.

  Wenn kein Upgrade zur Verfuegung steht, welches obigen Effekt
  bewirkt, sollte die Environment-Variable 'powerpc/Terminator' auf
  einen Wert ungleich Null gesetzt werden. Dann versucht WarpOS, die
  ppc.library und verwandte Resourcen von Hand zu entfernen. Falls das
  Probleme machen sollte, bitten wir um Benachrichtigung, damit man
  weitere Terminatoren entwickeln kann, welche die Probleme beseitigen.




- Problem:
  Jedes Demo, welches die powerpc.library oeffnet, stuerzt ab.

- Loesung:
  Auf Systemen ohne PPC-Board muss unbedingt die Env-Variable
  'noPPC' auf einen Wert ungleich Null gesetzt werden. Danach
  laufen alle Demos, welche auch ohne PPC auskommen (aber die
  powerpc.library zu oeffnen versuchen).



- Problem:
  Immer wenn ein Demo mehrmals in der Shell gestartet wurde, gibt
  es Abstuerze.

- Loesung:
  Das Problem tritt beispielsweise mit der WShell auf, welche Signale
  freigibt, welche sie selber nicht alloziert hat. Das Problem kann
  mit der Env-Variable 'earlyterm' behoben werden. Wenn diese Variable
  auf 1 gesetzt ist, sollten die Probleme beseitigt sein. Allerdings
  koennen dann keine globalen Einstellungen in der Shell mehr gemacht
  werden, welche den PPC betreffen, d.h. die Tools 'stackppc' und
  'changemmu' funktionieren nicht mehr. Der PPC-Stack muss dann mittels
  dem 'stack'-Befehl gesetzt werden (der PPC-Stack ist etwa doppelt
  so gross wie der 68K-Stack).


- Problem:
  Das Voxelspace-Demo laeuft seit der Version 1.6 nicht mehr mit
  Picasso96.

- Loesung:
  Seit Version 1.6 unterstuetzt das Voxelspace-Demo das OS3.0-
  Multibuffering fuer Picasso96 um eine noch bessere Bildqualitaet
  zu erreichen. Deswegen verlangt das Demo jetzt eine neuere
  Version von Picasso96.


- Problem:
  Beim Starten der Demos kommt ein Screenmode-Requester, welcher
  aber leer ist.

- Loesung:
  Dieser Effekt tritt auf, wenn mit einer CyberGFX-Emulation fuer
  AGA gearbeitet wird. In diesem Falle muessen die Demos mit dem
  Parameter 'PAL' gestartet werden.


- Problem:
  Es treten bei verschiedenen Programmen 'ramlib'-Abstuerze auf.

- Loesung:
  Dieser Effekt tritt bei neueren BlizzardPPC (bzw. mit neueren
  FlashROM-Versionen) auf, weil das AMIGA-OS so gepatcht wird,
  dass es ohne die ppc.library nicht mehr korrekt funktionieren
  kann. Deswegen musste eine neue Art der Terminierung fuer WarpOS
  entwickelt werden. Die Variable 'powerpc/terminator' sollte auf
  den Wert 2 gesetzt werden.


- Problem:
  Die WarpUp-Demos laufen EXTREM langsam.

- Loesung:
  Dann ist vermutlich die Debugging-Variable gesetzt. Die Variable
  'powerpc/debug' muss unbedingt auf Null gesetzt werden.


- Problem:
  Einige Applikationen, welche den Grafikkarten-Speicher direkt ansprechen,
  stuerzen ab.

- Loesung:
  Bei Verwendung von CyberVisionPPC/BVisionPPC Grafikkarten muss dem WarpOS
  der Adressraum des Adressraums bekanntgegeben werden. Dazu muessen folgende
  Variablen gesetzt werden:

  powerpc/force 1
  powerpc/gfxaddr $e0000000

  Der Installer von WarpUp V4 sollte diese Konfiguration automatisch
  durchfuehren.

