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 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 6.3 oder neuer Solaris x86 9 oder neuer NetBSD-current Mac OS X 10.4 oder neuer 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 oder 2.6.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. Mac OS X Info: Sie ben�tigen mindestens Xcode 2.4 um richtig unter x86 kompilieren zu k�nnen. 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, Red Hat XFree86-devel). 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. Optionale Support-Bibliotheken: Der ./configure Aufruf zeigt am Ende optionale Bibliotheken an, die von Wine benutzt werden k�nnen, aber auf dem System nicht vorhanden sind. Auf 64-Bit Plattformen ben�tigen Sie die 32-bit Versionen dieser Bibliotheken; siehe dazu http://wiki.winehq.org/WineOn64bit 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, wechseln Sie erst mit cd in das Wurzelverzeichnis dieses Releases (eins �ber dem, welches diese README-Datei enth�lt). Geben Sie dann "make clean" ein und patchen Sie das Release mit dem Kommando: bunzip2 -c Patch-Datei | patch -p1 wobei "Patch-Datei" der Name der Patch-Datei ist (sowas wie wine-1.0.x.diff.bz2). 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. Die 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 Notepad auszuf�hren: wine notepad (den Suchpfad, der in der Konfigurations-Datei wine notepad.exe angegeben wurde, benutzend) wine c:\\windows\\notepad.exe (die Dateinamen-Syntax von DOS benutzend) wine ~/.wine/drive_c/windows/notepad.exe (die Dateinamen-Syntax von Unix benutzend) wine notepad.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. 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. GIT: Der aktuelle Wine-Entwicklungs-Zweig ist �ber GIT verf�gbar. Besuchen Sie http://www.winehq.org/site/git 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. Wiki: Das Wine-Wiki finden Sie unter http://wiki.winehq.org 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