1. EINF�HRUNG Wine ist ein Programm, das es erm�glicht, Programme, die f�r Microsoft Windows geschrieben wurden (inklusive DOS-, Windows 3.x- und Win32- Bin�rdateien), unter Unix auszuf�hren. Es besteht aus einem Programm- Lader, der Microsoft Windows-Bin�rdateien l�dt und ausf�hrt, sowie einer Library (Winelib genannt), die Aufrufe der Windows API unter Verwendung der entsprechenden Unix- oder X11-Gegenst�cke implementiert. Die Library kann auch benutzt werden, um Win32-Code nativ nach Unix zu portieren. Wine ist Freie Software, die unter der GNU LGPL ver�ffentlicht wird; Bitte lesen Sie die Details in der Datei LICENSE nach. 2. SCHNELLSTART Um den Quelltext zu kompilieren, empfiehlt es sich immer, den Wine- Installer f�r den Build und die Installation von Wine zu verwenden. Rufen Sie dazu aus dem Wurzelverzeichnis des Wine-Quelltextes (das diese Datei enth�lt) das folgende Kommando auf: ./tools/wineinstall Starten Sie Programme mit "wine [Optionen] Programm". Weitere Informationen und Probleml�sungen entnehmen Sie bitte dem Rest dieser Datei, der Man-Page von Wine, den Dateien im Dokumentations-Verzeichnis des Wine-Quelltextes (siehe "DOKUMENTATION") und insbesondere der Vielzahl an Informationen, die Sie auf http://www.winehq.org finden. 3. VORAUSSETZUNGEN Um Wine kompilieren und ausf�hren zu k�nnen, brauchen Sie eines der folgenden Betriebssysteme: Linux version 2.0.36 oder neuer FreeBSD 4.x oder FreeBSD 5-CURRENT oder neuer Solaris x86 2.5 oder neuer NetBSD-current Da Wine Thread-Support auf Kernelebene ben�tigt, werden nur die oben aufgef�hrten Betriebssysteme unterst�tzt. Andere Betriebssysteme, die Kernel-Threads unterst�tzen, werden unter Umst�nden in der Zukunft unterst�tzt. Linux-Info: Obwohl Linux 2.2.x immer noch funktionieren sollte und Linux 2.0.x vielleicht auch noch funktioniert (�ltere 2.0.x-Versionen verzeichneten Abst�rze im Zusammenhang mit Threads), sollte man am besten einen aktuellen Kernel wie 2.4.x verwenden. FreeBSD-Info: Stellen Sie sicher, dass Sie die Optionen USER_LDT, SYSVSHM, SYSVSEM und SYSVMSG in Ihrem Kernel aktiviert haben. Weitere Informationen finden Sie im Ports-Tree: ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/ Solaris-Info: H�chstwahrscheinlich m�ssen Sie den Wine-Build mit der GNU-Toolchain (gcc, gas etc.) durchf�hren. Warnung: Die Installation von gas stellt nicht sicher, dass es vom gcc auch verwendet wird. Den gcc neu zu kompilieren, nach der Installation von gas, oder die Symbolischen Links von cc, as und ld mit den GNU-Tools zu verkn�pfen, soll ausreichend sein. NetBSD-Info: Stellen Sie sicher, dass Sie die Optionen USER_LDT, SYSVSHM, SYSVSEM und SYSVMSG in Ihrem Kernel aktiviert haben. Unterst�tzte Dateisysteme: Wine sollte auf den meisten Dateisystemen laufen. Jedoch wird Wine nicht starten, wenn umsdos f�r das Verzeichnis /tmp benutzt wird. Ein paar Kompatibilit�ts-Probleme wurden auch gemeldet beim Dateizugriff �ber Samba. Ausserdem k�nnen wir, da NTFS derzeit nur sicher f�r Lesezugriffe genutzt werden kann, den Einsatz von NTFS nicht empfehlen; Windows-Programme ben�tigen fast immer Schreibzugriffe. Kopieren Sie NTFS-Dateien an einen Ort, an dem Sie Schreibrechte haben. Grunds�tzliche Voraussetzungen: Sie m�ssen die Include-Dateien f�r X11-Entwicklung installiert haben (Debian nennt diese xlib6g-dev, RedHat XFree86-devel). Vorausgesetzte Build-Tools: Auf x86-Systemen wird der gcc >= 2.7.2 ben�tigt. Versionen vor 2.7.2.3 k�nnen Probleme damit haben, wenn bestimmte Dateien mit Optimierungen kompiliert werden, oft im Zusammenhang mit Problemen mit der Verwaltung von Header-Dateien. pgcc arbeitet derzeit nicht mit Wine. Die Ursache dieses Problems ist unbekannt. Nat�rlich ben�tigen Sie auch "make" (h�chstwahrscheinlich GNU make). Des Weiteren ben�tigen Sie flex in der Version 2.5 oder h�her und bison. Wenn Sie RedHat oder Debian benutzen, installieren Sie bitte die flex- und bison-Pakete. Optionale Support-Libraries: Wenn Sie CUPS Drucker-Unterst�tzung haben wollen, installieren Sie bitte die Pakete cups und cups-devel. Die Voraussetzungen f�r das selbst�ndige Durchf�hren des Builds der Dokumentation entnehmen Sie bitte dem Abschnitt "DOKUMENTATION". 4. KOMPILIEREN Wenn Sie sich daf�r entscheiden, wineinstall nicht zu benutzen, f�hren Sie bitte die folgenden Kommandos f�r den Build von Wine aus: ./configure make depend make Das erledigt den Build des Programms "wine" und verschiedener Support- Libraries / -Bin�rdateien. Das Programm "wine" l�dt ausf�hrbare Windows-Dateien und f�hrt sie aus. Die Library "libwine" ("WineLib") kann benutzt werden, um Windows-Quelltexte unter Unix zu kompilieren und zu verlinken. Mit ./configure --help k�nnen Sie sich die Konfigurations-Optionen f�r die Kompilierung anzeigen lassen. Um mit Hilfe einer Patch-Datei auf ein neueres Release zu aktualisieren, wechsen Sie erst mit cd in das Wurzelverzeichnis dieses Releases (das, welches diese README-Datei enth�lt). Geben Sie dann "make clean" ein und patchen Sie das Release mit dem Kommando: gunzip -c patch-file | patch -p1 wobei "patch-file" der Name der Patch-Datei ist (etwas wie Wine-yymmdd.diff.gz). Sie k�nnen dann erneut "./configure" und danach "make depend && make" aufrufen. 5. SETUP Nachdem der Build von Wine korrekt durchgelaufen ist, k�nnen Sie das Kommando "make install" aufrufen; Dadurch werden das Wine-Programm, die Man-Page und einige andere ben�tigte Dateien installiert. Vergessen Sie nicht, erst alle fr�heren Wine-Installationen zu entfernen. F�hren Sie vor der Installation entweder "dpkg -r wine", "rpm -e wine" oder "make uninstall" aus. Wenn Sie die mit dem Wine-Quelltext gelieferte Dokumentation lesen wollen, schauen Sie sich bitte den Abschnitt "DOKUMENTATION" an. Wine ben�tigt eine Konfigurations-Datei namens "config" in Ihrem ~/.wine-Verzeichnis. Das Format dieser Datei wird in der Man-Page der Konfigurations-Datei erkl�rt (documentation/wine.conf.man). Die Datei documentation/samples/config enth�lt eine beispielhafte Konfigurations-Datei, die angepasst und an die oben erw�hnte Stelle kopiert werden muss. Weitere Konfigurations-Hinweise finden Sie im Support-Bereich von http://www.winehq.org. Im Falle von Library-Ladefehlern (z.B. "Error while loading shared libraries: libntdll.so") f�gen Sie bitte den Library-Pfad zur Datei /etc/ld.so.conf hinzu und f�hren Sie ldconfig als root aus. 6. AUSF�HREN VON PROGRAMMEN Wenn Sie Wine aufrufen, k�nnen Sie den vollst�ndigen Pfad zur ausf�hrbaren Datei angeben oder nur einen Dateinamen. Beispiel: Um Solitaire auszuf�hren: wine sol (den Suchpfad, der in der Konfiguartions-Datei wine sol.exe angegeben wurde, benutzend) wine c:\\windows\\sol.exe (die Dateinamen-Syntax von DOS benutzend) wine /usr/windows/sol.exe (die Dateinamen-Syntax von Unix benutzend) wine sol.exe /parameter1 -parameter2 parameter3 (Programmaufruf mit Parametern) Hinweis: Der Pfad zur Datei wird auch zum Pfad hinzugef�gt, wenn ein vollst�ndiger Dateiname auf der Kommandozeile angegeben wird. Die Entwicklung von Wine ist noch nicht abgeschlossen, daher k�nnen einige Programme abst�rzen. Vorausgesetzt, dass Sie winedbg korrekt entsprechend documentation/debugger.sgml einrichten, werden Sie dann in einem Debugger landen, um das Problem untersuchen und beheben zu k�nnen. Weitere Informationen zu diesem Thema entnehmen Sie bitte der Datei documentation/debugging.sgml. Sie sollten Backups von allen wichtigen Dateien machen, auf die Sie Wine Zugriff gew�hren, oder spezielle Kopien f�r Wine anlegen, da Benutzer einige F�lle gemeldet haben, in denen Dateien zerst�rt wurden. F�hren Sie zum Beispiel NICHT den Explorer aus, wenn Sie kein geeignetes Backup haben, da er manchmal Verzeichnise verst�mmelt / umbenennnt. Selbst andere MS-Applikationen wie z.B der Messenger sind nicht sicher, da sie unter Umst�nden den Explorer aufrufen. Diese spezielle Besch�digung (!$!$!$!$.pfr) kann zumindest teilweise durch http://home.nexgo.de/andi.mohr/download/decorrupt_explorer behoben werden. 7. DOKUMENTATION Im Verzeichnis documentation/ befindet sich einiges an Dokumentation (verschiedene Wine-Guides usw.). Sie sind auch im WineHQ verf�gbar. Wenn Sie die SGML-Dateien dort verarbeiten m�chten, k�nnen Sie das Kommando "make doc" im Verzeichnis documentation/ ausf�hren. Daf�r wird das Paket "sgml tools" vorausgesetzt (f�r db2html, db2ps, db2pdf): Debian: docbook-utils Mandrake: sgml-tools-A.B.C-DDmdk SuSE: docbktls-A.BB.C-DD 8. WEITERF�HRENDE INFORMATIONEN WWW: Eine gro�e Anzahl an Informationen findet sich im WineHQ unter http://www.winehq.org/ : Verschiedene Wine Guides, Applikations-Datenbank, Fehlerverfolgungs-System. Das ist vermutlich der beste Ausgangspunkt. FAQ: Die FAQ zu Wine befindet sich unter http://www.winehq.org/FAQ Usenet: Hilfe und Diskussionen zu auf Wine bezogenen Problemen finden Sie unter comp.emulators.ms-windows.wine. Fehler: Melden Sie Fehler bitte an Wine-Bugzilla unter http://bugs.winehq.org Schauen Sie bitte erst in der Bugzilla-Datenbank nach, ob Ihr Problem bereits gemeldet wurde, bevor Sie eine Fehlermeldung verfassen. Sie k�nnen Fehlermeldungen auch an comp.emulators.ms-windows.wine schicken. Lesen Sie bitte die Datei documentation/bugs.sgml um zu sehen, welche Informationen ben�tigt werden. IRC: Online-Hilfe wird Ihnen im Chat-Kanal #WineHQ unter irc.freenode.net gew�hrt. CVS: Der aktuelle Wine-Entwicklungs-Tree ist �ber CVS verf�gbar. Besuchen Sie http://www.winehq.org/cvs f�r weitere Informationen. Mailing-Listen: Es gibt mehrere Mailing-Listen f�r die Wine-Entwickler; Schauen Sie sich bitte dazu http://www.winehq.org/forums an. Wenn Sie etwas hinzuf�gen oder einen Fehler beheben, senden Sie den Patch bitte (im 'diff -u'-Format) an die Liste wine-patches@winehq.org, um ihn in die n�chste Ausgabe aufnehmen zu k�nnen. -- Alexandre Julliard julliard@winehq.org �bersetzung von Christian Britz (Deutschland) Auf die �bersetzung bezogene Fehlermeldungen, Anregungen und Kommentare senden Sie bite an: cbritz@gmx.net